source: mainline/uspace/drv/nic/ne2k/ne2k.c@ 99013b84

Last change on this file since 99013b84 was 3a26925, checked in by Jakub Jermar <jakub@…>, 7 years ago

ne2k: Implement additional nic_iface_t ops

This commit implements the minimal set of nic_iface_t operations to make
the nic command successfully print out an entry for the NE2000 NIC.
  • Property mode set to 100644
File size: 11.7 KB
Line 
1/*
2 * Copyright (c) 2011 Martin Decky
3 * Copyright (c) 2011 Radim Vansa
4 * All rights reserved.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
9 *
10 * - Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * - Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * - The name of the author may not be used to endorse or promote products
16 * derived from this software without specific prior written permission.
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28 */
29
30/**
31 * @addtogroup drv_ne2k
32 * @brief Novell NE2000 NIC driver
33 * @{
34 */
35/**
36 * @file
37 * @brief Bridge between NICF, DDF and business logic for the NIC
38 */
39
40#include <stdio.h>
41#include <errno.h>
42#include <device/hw_res.h>
43#include <stdlib.h>
44#include <str_error.h>
45#include <async.h>
46#include "dp8390.h"
47
48#define NAME "ne2k"
49
50/** Return the ISR from the interrupt call.
51 *
52 * @param[in] call The interrupt call.
53 *
54 */
55#define IRQ_GET_ISR(call) ((int) IPC_GET_ARG2(call))
56
57/** Return the TSR from the interrupt call.
58 *
59 * @param[in] call The interrupt call.
60 *
61 */
62#define IRQ_GET_TSR(call) ((int) IPC_GET_ARG3(call))
63
64#define DRIVER_DATA(dev) ((nic_t *) ddf_dev_data_get(dev))
65#define NE2K(device) ((ne2k_t *) nic_get_specific(DRIVER_DATA(device)))
66
67static irq_pio_range_t ne2k_ranges_prototype[] = {
68 {
69 .base = 0,
70 .size = NE2K_IO_SIZE,
71 }
72};
73
74/** NE2000 kernel interrupt command sequence.
75 *
76 */
77static irq_cmd_t ne2k_cmds_prototype[] = {
78 {
79 /* Read Interrupt Status Register */
80 .cmd = CMD_PIO_READ_8,
81 .addr = NULL,
82 .dstarg = 2
83 },
84 {
85 /* Mask supported interrupt causes */
86 .cmd = CMD_AND,
87 .value = (ISR_PRX | ISR_PTX | ISR_RXE | ISR_TXE | ISR_OVW |
88 ISR_CNT | ISR_RDC),
89 .srcarg = 2,
90 .dstarg = 3,
91 },
92 {
93 /* Predicate for accepting the interrupt */
94 .cmd = CMD_PREDICATE,
95 .value = 4,
96 .srcarg = 3
97 },
98 {
99 /*
100 * Mask future interrupts via
101 * Interrupt Mask Register
102 */
103 .cmd = CMD_PIO_WRITE_8,
104 .addr = NULL,
105 .value = 0
106 },
107 {
108 /* Acknowledge the current interrupt */
109 .cmd = CMD_PIO_WRITE_A_8,
110 .addr = NULL,
111 .srcarg = 3
112 },
113 {
114 /* Read Transmit Status Register */
115 .cmd = CMD_PIO_READ_8,
116 .addr = NULL,
117 .dstarg = 3
118 },
119 {
120 .cmd = CMD_ACCEPT
121 }
122};
123
124static void ne2k_interrupt_handler(ipc_call_t *, ddf_dev_t *);
125
126static errno_t ne2k_register_interrupt(nic_t *nic_data,
127 cap_irq_handle_t *handle)
128{
129 ne2k_t *ne2k = (ne2k_t *) nic_get_specific(nic_data);
130
131 if (ne2k->code.cmdcount == 0) {
132 irq_pio_range_t *ne2k_ranges;
133 irq_cmd_t *ne2k_cmds;
134
135 ne2k_ranges = malloc(sizeof(ne2k_ranges_prototype));
136 if (!ne2k_ranges)
137 return ENOMEM;
138 memcpy(ne2k_ranges, ne2k_ranges_prototype,
139 sizeof(ne2k_ranges_prototype));
140 ne2k_ranges[0].base = (uintptr_t) ne2k->base_port;
141
142 ne2k_cmds = malloc(sizeof(ne2k_cmds_prototype));
143 if (!ne2k_cmds) {
144 free(ne2k_ranges);
145 return ENOMEM;
146 }
147 memcpy(ne2k_cmds, ne2k_cmds_prototype,
148 sizeof(ne2k_cmds_prototype));
149 ne2k_cmds[0].addr = ne2k->base_port + DP_ISR;
150 ne2k_cmds[3].addr = ne2k->base_port + DP_IMR;
151 ne2k_cmds[4].addr = ne2k_cmds[0].addr;
152 ne2k_cmds[5].addr = ne2k->base_port + DP_TSR;
153
154 ne2k->code.rangecount = sizeof(ne2k_ranges_prototype) /
155 sizeof(irq_pio_range_t);
156 ne2k->code.ranges = ne2k_ranges;
157
158 ne2k->code.cmdcount = sizeof(ne2k_cmds_prototype) /
159 sizeof(irq_cmd_t);
160 ne2k->code.cmds = ne2k_cmds;
161 }
162
163 return register_interrupt_handler(nic_get_ddf_dev(nic_data),
164 ne2k->irq, ne2k_interrupt_handler, &ne2k->code, handle);
165}
166
167static ddf_dev_ops_t ne2k_dev_ops;
168
169static void ne2k_dev_cleanup(ddf_dev_t *dev)
170{
171 if (ddf_dev_data_get(dev) != NULL) {
172 ne2k_t *ne2k = NE2K(dev);
173 if (ne2k) {
174 free(ne2k->code.ranges);
175 free(ne2k->code.cmds);
176 }
177 nic_unbind_and_destroy(dev);
178 }
179}
180
181static errno_t ne2k_dev_init(nic_t *nic_data)
182{
183 /* Get HW resources */
184 hw_res_list_parsed_t hw_res_parsed;
185 hw_res_list_parsed_init(&hw_res_parsed);
186
187 errno_t rc = nic_get_resources(nic_data, &hw_res_parsed);
188
189 if (rc != EOK)
190 goto failed;
191
192 if (hw_res_parsed.irqs.count == 0) {
193 rc = EINVAL;
194 goto failed;
195 }
196
197 if (hw_res_parsed.io_ranges.count == 0) {
198 rc = EINVAL;
199 goto failed;
200 }
201
202 if (hw_res_parsed.io_ranges.ranges[0].size < NE2K_IO_SIZE) {
203 rc = EINVAL;
204 goto failed;
205 }
206
207 ne2k_t *ne2k = (ne2k_t *) nic_get_specific(nic_data);
208 ne2k->irq = hw_res_parsed.irqs.irqs[0];
209
210 addr_range_t regs = hw_res_parsed.io_ranges.ranges[0];
211 ne2k->base_port = RNGABSPTR(regs);
212
213 hw_res_list_parsed_clean(&hw_res_parsed);
214
215 /* Enable programmed I/O */
216 if (pio_enable_range(&regs, &ne2k->port) != EOK)
217 return EADDRNOTAVAIL;
218
219 ne2k->data_port = ne2k->port + NE2K_DATA;
220 ne2k->receive_configuration = RCR_AB | RCR_AM;
221 ne2k->probed = false;
222 ne2k->up = false;
223
224 /* Find out whether the device is present. */
225 if (ne2k_probe(ne2k) != EOK)
226 return ENOENT;
227
228 ne2k->probed = true;
229
230 if (ne2k_register_interrupt(nic_data, NULL) != EOK)
231 return EINVAL;
232
233 return EOK;
234
235failed:
236 hw_res_list_parsed_clean(&hw_res_parsed);
237 return rc;
238}
239
240void ne2k_interrupt_handler(ipc_call_t *call, ddf_dev_t *dev)
241{
242 nic_t *nic_data = DRIVER_DATA(dev);
243 ne2k_interrupt(nic_data, IRQ_GET_ISR(*call), IRQ_GET_TSR(*call));
244}
245
246static errno_t ne2k_on_activating(nic_t *nic_data)
247{
248 ne2k_t *ne2k = (ne2k_t *) nic_get_specific(nic_data);
249
250 if (!ne2k->up) {
251 errno_t rc = ne2k_up(ne2k);
252 if (rc != EOK)
253 return rc;
254
255 rc = hw_res_enable_interrupt(ne2k->parent_sess, ne2k->irq);
256 if (rc != EOK) {
257 ne2k_down(ne2k);
258 return rc;
259 }
260 }
261 return EOK;
262}
263
264static errno_t ne2k_on_stopping(nic_t *nic_data)
265{
266 ne2k_t *ne2k = (ne2k_t *) nic_get_specific(nic_data);
267
268 (void) hw_res_disable_interrupt(ne2k->parent_sess, ne2k->irq);
269 ne2k->receive_configuration = RCR_AB | RCR_AM;
270 ne2k_down(ne2k);
271 return EOK;
272}
273
274static errno_t ne2k_set_address(ddf_fun_t *fun, const nic_address_t *address)
275{
276 nic_t *nic_data = DRIVER_DATA(ddf_fun_get_dev(fun));
277 errno_t rc = nic_report_address(nic_data, address);
278 if (rc != EOK) {
279 return EINVAL;
280 }
281 /* Note: some frame with previous physical address may slip to NIL here
282 * (for a moment the filtering is not exact), but ethernet should be OK with
283 * that. Some frames may also be lost, but this is not a problem.
284 */
285 ne2k_set_physical_address((ne2k_t *) nic_get_specific(nic_data), address);
286 return EOK;
287}
288
289static errno_t ne2k_get_device_info(ddf_fun_t *fun, nic_device_info_t *info)
290{
291 nic_t *nic_data = nic_get_from_ddf_fun(fun);
292 if (!nic_data)
293 return ENOENT;
294
295 str_cpy(info->vendor_name, sizeof(info->vendor_name), "Novell");
296 str_cpy(info->model_name, sizeof(info->model_name), "NE2000");
297
298 return EOK;
299}
300
301static errno_t ne2k_get_cable_state(ddf_fun_t *fun, nic_cable_state_t *state)
302{
303 *state = NIC_CS_PLUGGED;
304 return EOK;
305}
306
307static errno_t ne2k_get_operation_mode(ddf_fun_t *fun, int *speed,
308 nic_channel_mode_t *duplex, nic_role_t *role)
309{
310 *speed = 10;
311 *duplex = NIC_CM_HALF_DUPLEX; // XXX
312 *role = NIC_ROLE_UNKNOWN;
313 return EOK;
314}
315
316static errno_t ne2k_on_unicast_mode_change(nic_t *nic_data,
317 nic_unicast_mode_t new_mode,
318 const nic_address_t *address_list, size_t address_count)
319{
320 ne2k_t *ne2k = (ne2k_t *) nic_get_specific(nic_data);
321 switch (new_mode) {
322 case NIC_UNICAST_BLOCKED:
323 ne2k_set_promisc_phys(ne2k, false);
324 nic_report_hw_filtering(nic_data, 0, -1, -1);
325 return EOK;
326 case NIC_UNICAST_DEFAULT:
327 ne2k_set_promisc_phys(ne2k, false);
328 nic_report_hw_filtering(nic_data, 1, -1, -1);
329 return EOK;
330 case NIC_UNICAST_LIST:
331 ne2k_set_promisc_phys(ne2k, true);
332 nic_report_hw_filtering(nic_data, 0, -1, -1);
333 return EOK;
334 case NIC_UNICAST_PROMISC:
335 ne2k_set_promisc_phys(ne2k, true);
336 nic_report_hw_filtering(nic_data, 1, -1, -1);
337 return EOK;
338 default:
339 return ENOTSUP;
340 }
341}
342
343static errno_t ne2k_on_multicast_mode_change(nic_t *nic_data,
344 nic_multicast_mode_t new_mode,
345 const nic_address_t *address_list, size_t address_count)
346{
347 ne2k_t *ne2k = (ne2k_t *) nic_get_specific(nic_data);
348 switch (new_mode) {
349 case NIC_MULTICAST_BLOCKED:
350 ne2k_set_accept_mcast(ne2k, false);
351 nic_report_hw_filtering(nic_data, -1, 1, -1);
352 return EOK;
353 case NIC_MULTICAST_LIST:
354 ne2k_set_accept_mcast(ne2k, true);
355 ne2k_set_mcast_hash(ne2k,
356 nic_mcast_hash(address_list, address_count));
357 nic_report_hw_filtering(nic_data, -1, 0, -1);
358 return EOK;
359 case NIC_MULTICAST_PROMISC:
360 ne2k_set_accept_mcast(ne2k, true);
361 ne2k_set_mcast_hash(ne2k, 0xFFFFFFFFFFFFFFFFllu);
362 nic_report_hw_filtering(nic_data, -1, 1, -1);
363 return EOK;
364 default:
365 return ENOTSUP;
366 }
367}
368
369static errno_t ne2k_on_broadcast_mode_change(nic_t *nic_data,
370 nic_broadcast_mode_t new_mode)
371{
372 ne2k_t *ne2k = (ne2k_t *) nic_get_specific(nic_data);
373 switch (new_mode) {
374 case NIC_BROADCAST_BLOCKED:
375 ne2k_set_accept_bcast(ne2k, false);
376 return EOK;
377 case NIC_BROADCAST_ACCEPTED:
378 ne2k_set_accept_bcast(ne2k, true);
379 return EOK;
380 default:
381 return ENOTSUP;
382 }
383}
384
385static errno_t ne2k_dev_add(ddf_dev_t *dev)
386{
387 ddf_fun_t *fun;
388
389 /* Allocate driver data for the device. */
390 nic_t *nic_data = nic_create_and_bind(dev);
391 if (nic_data == NULL)
392 return ENOMEM;
393
394 nic_set_send_frame_handler(nic_data, ne2k_send);
395 nic_set_state_change_handlers(nic_data,
396 ne2k_on_activating, NULL, ne2k_on_stopping);
397 nic_set_filtering_change_handlers(nic_data,
398 ne2k_on_unicast_mode_change, ne2k_on_multicast_mode_change,
399 ne2k_on_broadcast_mode_change, NULL, NULL);
400
401 ne2k_t *ne2k = malloc(sizeof(ne2k_t));
402 if (NULL != ne2k) {
403 memset(ne2k, 0, sizeof(ne2k_t));
404 nic_set_specific(nic_data, ne2k);
405 } else {
406 nic_unbind_and_destroy(dev);
407 return ENOMEM;
408 }
409
410 ne2k->dev = dev;
411 ne2k->parent_sess = ddf_dev_parent_sess_get(dev);
412 if (ne2k->parent_sess == NULL) {
413 ne2k_dev_cleanup(dev);
414 return ENOMEM;
415 }
416
417 errno_t rc = ne2k_dev_init(nic_data);
418 if (rc != EOK) {
419 ne2k_dev_cleanup(dev);
420 return rc;
421 }
422
423 rc = nic_report_address(nic_data, &ne2k->mac);
424 if (rc != EOK) {
425 ne2k_dev_cleanup(dev);
426 return rc;
427 }
428
429 fun = ddf_fun_create(nic_get_ddf_dev(nic_data), fun_exposed, "port0");
430 if (fun == NULL) {
431 ne2k_dev_cleanup(dev);
432 return ENOMEM;
433 }
434
435 nic_set_ddf_fun(nic_data, fun);
436 ddf_fun_set_ops(fun, &ne2k_dev_ops);
437
438 rc = ddf_fun_bind(fun);
439 if (rc != EOK) {
440 ddf_fun_destroy(fun);
441 ne2k_dev_cleanup(dev);
442 return rc;
443 }
444
445 rc = ddf_fun_add_to_category(fun, DEVICE_CATEGORY_NIC);
446 if (rc != EOK) {
447 ddf_fun_unbind(fun);
448 ddf_fun_destroy(fun);
449 return rc;
450 }
451
452 return EOK;
453}
454
455static nic_iface_t ne2k_nic_iface = {
456 .set_address = ne2k_set_address,
457 .get_device_info = ne2k_get_device_info,
458 .get_cable_state = ne2k_get_cable_state,
459 .get_operation_mode = ne2k_get_operation_mode,
460};
461
462static driver_ops_t ne2k_driver_ops = {
463 .dev_add = ne2k_dev_add
464};
465
466static driver_t ne2k_driver = {
467 .name = NAME,
468 .driver_ops = &ne2k_driver_ops
469};
470
471int main(int argc, char *argv[])
472{
473 printf("%s: HelenOS NE 2000 network adapter driver\n", NAME);
474
475 nic_driver_init(NAME);
476 nic_driver_implement(&ne2k_driver_ops, &ne2k_dev_ops, &ne2k_nic_iface);
477
478 return ddf_driver_main(&ne2k_driver);
479}
480
481/** @}
482 */
Note: See TracBrowser for help on using the repository browser.