Pull networking updates from David Miller: 1) Allow setting bluetooth L2CAP modes via socket option, from Luiz Augusto von Dentz. 2) Add GSO partial support to igc, from Sasha Neftin. 3) Several cleanups and improvements to r8169 from Heiner Kallweit. 4) Add IF_OPER_TESTING link state and use it when ethtool triggers a device self-test. From Andrew Lunn. 5) Start moving away from custom driver versions, use the globally defined kernel version instead, from Leon Romanovsky. 6) Support GRO vis gro_cells in DSA layer, from Alexander Lobakin. 7) Allow hard IRQ deferral during NAPI, from Eric Dumazet. 8) Add sriov and vf support to hinic, from Luo bin. 9) Support Media Redundancy Protocol (MRP) in the bridging code, from Horatiu Vultur. 10) Support netmap in the nft_nat code, from Pablo Neira Ayuso. 11) Allow UDPv6 encapsulation of ESP in the ipsec code, from Sabrina Dubroca. Also add ipv6 support for espintcp. 12) Lots of ReST conversions of the networking documentation, from Mauro Carvalho Chehab. 13) Support configuration of ethtool rxnfc flows in bcmgenet driver, from Doug Berger. 14) Allow to dump cgroup id and filter by it in inet_diag code, from Dmitry Yakunin. 15) Add infrastructure to export netlink attribute policies to userspace, from Johannes Berg. 16) Several optimizations to sch_fq scheduler, from Eric Dumazet. 17) Fallback to the default qdisc if qdisc init fails because otherwise a packet scheduler init failure will make a device inoperative. From Jesper Dangaard Brouer. 18) Several RISCV bpf jit optimizations, from Luke Nelson. 19) Correct the return type of the ->ndo_start_xmit() method in several drivers, it's netdev_tx_t but many drivers were using 'int'. From Yunjian Wang. 20) Add an ethtool interface for PHY master/slave config, from Oleksij Rempel. 21) Add BPF iterators, from Yonghang Song. 22) Add cable test infrastructure, including ethool interfaces, from Andrew Lunn. Marvell PHY driver is the first to support this facility. 23) Remove zero-length arrays all over, from Gustavo A. R. Silva. 24) Calculate and maintain an explicit frame size in XDP, from Jesper Dangaard Brouer. 25) Add CAP_BPF, from Alexei Starovoitov. 26) Support terse dumps in the packet scheduler, from Vlad Buslov. 27) Support XDP_TX bulking in dpaa2 driver, from Ioana Ciornei. 28) Add devm_register_netdev(), from Bartosz Golaszewski. 29) Minimize qdisc resets, from Cong Wang. 30) Get rid of kernel_getsockopt and kernel_setsockopt in order to eliminate set_fs/get_fs calls. From Christoph Hellwig. * git://git.kernel.org/pub/scm/linux/kernel/git/netdev/net-next: (2517 commits) selftests: net: ip_defrag: ignore EPERM net_failover: fixed rollback in net_failover_open() Revert "tipc: Fix potential tipc_aead refcnt leak in tipc_crypto_rcv" Revert "tipc: Fix potential tipc_node refcnt leak in tipc_rcv" vmxnet3: allow rx flow hash ops only when rss is enabled hinic: add set_channels ethtool_ops support selftests/bpf: Add a default $(CXX) value tools/bpf: Don't use $(COMPILE.c) bpf, selftests: Use bpf_probe_read_kernel s390/bpf: Use bcr 0,%0 as tail call nop filler s390/bpf: Maintain 8-byte stack alignment selftests/bpf: Fix verifier test selftests/bpf: Fix sample_cnt shared between two threads bpf, selftests: Adapt cls_redirect to call csum_level helper bpf: Add csum_level helper for fixing up csum levels bpf: Fix up bpf_skb_adjust_room helper's skb csum setting sfc: add missing annotation for efx_ef10_try_update_nic_stats_vf() crypto/chtls: IPv6 support for inline TLS Crypto/chcr: Fixes a coccinile check error Crypto/chcr: Fixes compilations warnings ...
Unified · Split
| @@ -124,6 +124,19 @@ Description: · 123 unmodified lines | ||
| 124 | 124 | authentication is performed (e.g: 802.1x). 'link_mode' attribute |
| 125 | 125 | will also reflect the dormant state. |
| 126 | 126 | |
| 127 | +What: /sys/class/net/<iface>/testing | |
| 128 | +Date: April 2002 | |
| 129 | +KernelVersion: 5.8 | |
| 130 | +Contact: netdev@vger.kernel.org | |
| 131 | +Description: | |
| 132 | + Indicates whether the interface is under test. Possible | |
| 133 | + values are: | |
| 134 | + 0: interface is not being tested | |
| 135 | + 1: interface is being tested | |
| 136 | + | |
| 137 | + When an interface is under test, it cannot be expected | |
| 138 | + to pass packets as normal. | |
| 139 | + | |
| 127 | 140 | What: /sys/clas/net/<iface>/duplex |
| 128 | 141 | Date: October 2009 |
| 129 | 142 | KernelVersion: 2.6.33 |
| @@ -356,7 +356,7 @@ · 355 unmodified lines | ||
| 356 | 356 | shot down by NMI |
| 357 | 357 | |
| 358 | 358 | autoconf= [IPV6] |
| 359 | − See Documentation/networking/ipv6.txt. | |
| 359 | + See Documentation/networking/ipv6.rst. | |
| 360 | 360 | |
| 361 | 361 | show_lapic= [APIC,X86] Advanced Programmable Interrupt Controller |
| 362 | 362 | Limit apic dumping. The parameter defines the maximal |
| @@ -638,7 +638,7 @@ · 275 unmodified lines | ||
| 638 | 638 | |
| 639 | 639 | See Documentation/admin-guide/serial-console.rst for more |
| 640 | 640 | information. See |
| 641 | − Documentation/networking/netconsole.txt for an | |
| 641 | + Documentation/networking/netconsole.rst for an | |
| 642 | 642 | alternative. |
| 643 | 643 | |
| 644 | 644 | uart[8250],io,<addr>[,options] |
| @@ -831,7 +831,7 @@ · 186 unmodified lines | ||
| 831 | 831 | |
| 832 | 832 | decnet.addr= [HW,NET] |
| 833 | 833 | Format: <area>[,<node>] |
| 834 | − See also Documentation/networking/decnet.txt. | |
| 834 | + See also Documentation/networking/decnet.rst. | |
| 835 | 835 | |
| 836 | 836 | default_hugepagesz= |
| 837 | 837 | [same as hugepagesz=] The size of the default |
| @@ -872,7 +872,7 @@ · 34 unmodified lines | ||
| 872 | 872 | miss to occur. |
| 873 | 873 | |
| 874 | 874 | disable= [IPV6] |
| 875 | − See Documentation/networking/ipv6.txt. | |
| 875 | + See Documentation/networking/ipv6.rst. | |
| 876 | 876 | |
| 877 | 877 | hardened_usercopy= |
| 878 | 878 | [KNL] Under CONFIG_HARDENED_USERCOPY, whether |
| @@ -912,7 +912,7 @@ · 33 unmodified lines | ||
| 912 | 912 | to workaround buggy firmware. |
| 913 | 913 | |
| 914 | 914 | disable_ipv6= [IPV6] |
| 915 | − See Documentation/networking/ipv6.txt. | |
| 915 | + See Documentation/networking/ipv6.rst. | |
| 916 | 916 | |
| 917 | 917 | disable_mtrr_cleanup [X86] |
| 918 | 918 | The kernel tries to adjust MTRR layout from continuous |
| @@ -4956,7 +4956,7 @@ · 4037 unmodified lines | ||
| 4956 | 4956 | Set the number of tcp_metrics_hash slots. |
| 4957 | 4957 | Default value is 8192 or 16384 depending on total |
| 4958 | 4958 | ram pages. This is used to specify the TCP metrics |
| 4959 | − cache size. See Documentation/networking/ip-sysctl.txt | |
| 4959 | + cache size. See Documentation/networking/ip-sysctl.rst | |
| 4960 | 4960 | "tcp_no_metrics_save" section for more details. |
| 4961 | 4961 | |
| 4962 | 4962 | tdfx= [HW,DRM] |
| @@ -54,7 +54,7 @@ You will need to create a new device to use ``/dev/console``. The official · 53 unmodified lines | ||
| 54 | 54 | ``/dev/console`` is now character device 5,1. |
| 55 | 55 | |
| 56 | 56 | (You can also use a network device as a console. See |
| 57 | −``Documentation/networking/netconsole.txt`` for information on that.) | |
| 57 | +``Documentation/networking/netconsole.rst`` for information on that.) | |
| 58 | 58 | |
| 59 | 59 | Here's an example that will use ``/dev/ttyS1`` (COM2) as the console. |
| 60 | 60 | Replace the sample values as needed. |
| @@ -339,7 +339,9 @@ settings from init_net and for IPv6 we reset all settings to default. · 338 unmodified lines | ||
| 339 | 339 | |
| 340 | 340 | If set to 1, both IPv4 and IPv6 settings are forced to inherit from |
| 341 | 341 | current ones in init_net. If set to 2, both IPv4 and IPv6 settings are |
| 342 | −forced to reset to their default values. | |
| 342 | +forced to reset to their default values. If set to 3, both IPv4 and IPv6 | |
| 343 | +settings are forced to inherit from current ones in the netns where this | |
| 344 | +new netns has been created. | |
| 343 | 345 | |
| 344 | 346 | Default : 0 (for compatibility reasons) |
| 345 | 347 | |
| @@ -353,8 +355,8 @@ socket's buffer. It will not take effect unless PF_UNIX flag is specified. · 7 unmodified lines | ||
| 353 | 355 | |
| 354 | 356 | 3. /proc/sys/net/ipv4 - IPV4 settings |
| 355 | 357 | ------------------------------------- |
| 356 | −Please see: Documentation/networking/ip-sysctl.txt and ipvs-sysctl.txt for | |
| 357 | −descriptions of these entries. | |
| 358 | +Please see: Documentation/networking/ip-sysctl.rst and | |
| 359 | +Documentation/admin-guide/sysctl/net.rst for descriptions of these entries. | |
| 358 | 360 | |
| 359 | 361 | |
| 360 | 362 | 4. Appletalk |
| @@ -437,6 +437,21 @@ needed:: · 436 unmodified lines | ||
| 437 | 437 | See the kernels selftest `Documentation/dev-tools/kselftest.rst`_ |
| 438 | 438 | document for further documentation. |
| 439 | 439 | |
| 440 | +To maximize the number of tests passing, the .config of the kernel | |
| 441 | +under test should match the config file fragment in | |
| 442 | +tools/testing/selftests/bpf as closely as possible. | |
| 443 | + | |
| 444 | +Finally to ensure support for latest BPF Type Format features - | |
| 445 | +discussed in `Documentation/bpf/btf.rst`_ - pahole version 1.16 | |
| 446 | +is required for kernels built with CONFIG_DEBUG_INFO_BTF=y. | |
| 447 | +pahole is delivered in the dwarves package or can be built | |
| 448 | +from source at | |
| 449 | + | |
| 450 | +https://github.com/acmel/dwarves | |
| 451 | + | |
| 452 | +Some distros have pahole version 1.16 packaged already, e.g. | |
| 453 | +Fedora, Gentoo. | |
| 454 | + | |
| 440 | 455 | Q: Which BPF kernel selftests version should I run my kernel against? |
| 441 | 456 | --------------------------------------------------------------------- |
| 442 | 457 | A: If you run a kernel ``xyz``, then always run the BPF kernel selftests |
| @@ -7,7 +7,7 @@ Filter) facility, with a focus on the extended BPF version (eBPF). · 6 unmodified lines | ||
| 7 | 7 | |
| 8 | 8 | This kernel side documentation is still work in progress. The main |
| 9 | 9 | textual documentation is (for historical reasons) described in |
| 10 | −`Documentation/networking/filter.txt`_, which describe both classical | |
| 10 | +`Documentation/networking/filter.rst`_, which describe both classical | |
| 11 | 11 | and extended BPF instruction-set. |
| 12 | 12 | The Cilium project also maintains a `BPF and XDP Reference Guide`_ |
| 13 | 13 | that goes into great technical depth about the BPF Architecture. |
| @@ -59,7 +59,7 @@ Testing and debugging BPF · 45 unmodified lines | ||
| 59 | 59 | |
| 60 | 60 | |
| 61 | 61 | .. Links: |
| 62 | −.. _Documentation/networking/filter.txt: ../networking/filter.txt | |
| 62 | +.. _Documentation/networking/filter.rst: ../networking/filter.txt | |
| 63 | 63 | .. _man-pages: https://www.kernel.org/doc/man-pages/ |
| 64 | 64 | .. _bpf(2): http://man7.org/linux/man-pages/man2/bpf.2.html |
| 65 | 65 | .. _BPF and XDP Reference Guide: http://cilium.readthedocs.io/en/latest/bpf/ |
| @@ -0,0 +1,209 @@ | ||
| 1 | +=============== | |
| 2 | +BPF ring buffer | |
| 3 | +=============== | |
| 4 | + | |
| 5 | +This document describes BPF ring buffer design, API, and implementation details. | |
| 6 | + | |
| 7 | +.. contents:: | |
| 8 | + :local: | |
| 9 | + :depth: 2 | |
| 10 | + | |
| 11 | +Motivation | |
| 12 | +---------- | |
| 13 | + | |
| 14 | +There are two distinctive motivators for this work, which are not satisfied by | |
| 15 | +existing perf buffer, which prompted creation of a new ring buffer | |
| 16 | +implementation. | |
| 17 | + | |
| 18 | +- more efficient memory utilization by sharing ring buffer across CPUs; | |
| 19 | +- preserving ordering of events that happen sequentially in time, even across | |
| 20 | + multiple CPUs (e.g., fork/exec/exit events for a task). | |
| 21 | + | |
| 22 | +These two problems are independent, but perf buffer fails to satisfy both. | |
| 23 | +Both are a result of a choice to have per-CPU perf ring buffer. Both can be | |
| 24 | +also solved by having an MPSC implementation of ring buffer. The ordering | |
| 25 | +problem could technically be solved for perf buffer with some in-kernel | |
| 26 | +counting, but given the first one requires an MPSC buffer, the same solution | |
| 27 | +would solve the second problem automatically. | |
| 28 | + | |
| 29 | +Semantics and APIs | |
| 30 | +------------------ | |
| 31 | + | |
| 32 | +Single ring buffer is presented to BPF programs as an instance of BPF map of | |
| 33 | +type ``BPF_MAP_TYPE_RINGBUF``. Two other alternatives considered, but | |
| 34 | +ultimately rejected. | |
| 35 | + | |
| 36 | +One way would be to, similar to ``BPF_MAP_TYPE_PERF_EVENT_ARRAY``, make | |
| 37 | +``BPF_MAP_TYPE_RINGBUF`` could represent an array of ring buffers, but not | |
| 38 | +enforce "same CPU only" rule. This would be more familiar interface compatible | |
| 39 | +with existing perf buffer use in BPF, but would fail if application needed more | |
| 40 | +advanced logic to lookup ring buffer by arbitrary key. | |
| 41 | +``BPF_MAP_TYPE_HASH_OF_MAPS`` addresses this with current approach. | |
| 42 | +Additionally, given the performance of BPF ringbuf, many use cases would just | |
| 43 | +opt into a simple single ring buffer shared among all CPUs, for which current | |
| 44 | +approach would be an overkill. | |
| 45 | + | |
| 46 | +Another approach could introduce a new concept, alongside BPF map, to represent | |
| 47 | +generic "container" object, which doesn't necessarily have key/value interface | |
| 48 | +with lookup/update/delete operations. This approach would add a lot of extra | |
| 49 | +infrastructure that has to be built for observability and verifier support. It | |
| 50 | +would also add another concept that BPF developers would have to familiarize | |
| 51 | +themselves with, new syntax in libbpf, etc. But then would really provide no | |
| 52 | +additional benefits over the approach of using a map. ``BPF_MAP_TYPE_RINGBUF`` | |
| 53 | +doesn't support lookup/update/delete operations, but so doesn't few other map | |
| 54 | +types (e.g., queue and stack; array doesn't support delete, etc). | |
| 55 | + | |
| 56 | +The approach chosen has an advantage of re-using existing BPF map | |
| 57 | +infrastructure (introspection APIs in kernel, libbpf support, etc), being | |
| 58 | +familiar concept (no need to teach users a new type of object in BPF program), | |
| 59 | +and utilizing existing tooling (bpftool). For common scenario of using a single | |
| 60 | +ring buffer for all CPUs, it's as simple and straightforward, as would be with | |
| 61 | +a dedicated "container" object. On the other hand, by being a map, it can be | |
| 62 | +combined with ``ARRAY_OF_MAPS`` and ``HASH_OF_MAPS`` map-in-maps to implement | |
| 63 | +a wide variety of topologies, from one ring buffer for each CPU (e.g., as | |
| 64 | +a replacement for perf buffer use cases), to a complicated application | |
| 65 | +hashing/sharding of ring buffers (e.g., having a small pool of ring buffers | |
| 66 | +with hashed task's tgid being a look up key to preserve order, but reduce | |
| 67 | +contention). | |
| 68 | + | |
| 69 | +Key and value sizes are enforced to be zero. ``max_entries`` is used to specify | |
| 70 | +the size of ring buffer and has to be a power of 2 value. | |
| 71 | + | |
| 72 | +There are a bunch of similarities between perf buffer | |
| 73 | +(``BPF_MAP_TYPE_PERF_EVENT_ARRAY``) and new BPF ring buffer semantics: | |
| 74 | + | |
| 75 | +- variable-length records; | |
| 76 | +- if there is no more space left in ring buffer, reservation fails, no | |
| 77 | + blocking; | |
| 78 | +- memory-mappable data area for user-space applications for ease of | |
| 79 | + consumption and high performance; | |
| 80 | +- epoll notifications for new incoming data; | |
| 81 | +- but still the ability to do busy polling for new data to achieve the | |
| 82 | + lowest latency, if necessary. | |
| 83 | + | |
| 84 | +BPF ringbuf provides two sets of APIs to BPF programs: | |
| 85 | + | |
| 86 | +- ``bpf_ringbuf_output()`` allows to *copy* data from one place to a ring | |
| 87 | + buffer, similarly to ``bpf_perf_event_output()``; | |
| 88 | +- ``bpf_ringbuf_reserve()``/``bpf_ringbuf_commit()``/``bpf_ringbuf_discard()`` | |
| 89 | + APIs split the whole process into two steps. First, a fixed amount of space | |
| 90 | + is reserved. If successful, a pointer to a data inside ring buffer data | |
| 91 | + area is returned, which BPF programs can use similarly to a data inside | |
| 92 | + array/hash maps. Once ready, this piece of memory is either committed or | |
| 93 | + discarded. Discard is similar to commit, but makes consumer ignore the | |
| 94 | + record. | |
| 95 | + | |
| 96 | +``bpf_ringbuf_output()`` has disadvantage of incurring extra memory copy, | |
| 97 | +because record has to be prepared in some other place first. But it allows to | |
| 98 | +submit records of the length that's not known to verifier beforehand. It also | |
| 99 | +closely matches ``bpf_perf_event_output()``, so will simplify migration | |
| 100 | +significantly. | |
| 101 | + | |
| 102 | +``bpf_ringbuf_reserve()`` avoids the extra copy of memory by providing a memory | |
| 103 | +pointer directly to ring buffer memory. In a lot of cases records are larger | |
| 104 | +than BPF stack space allows, so many programs have use extra per-CPU array as | |
| 105 | +a temporary heap for preparing sample. bpf_ringbuf_reserve() avoid this needs | |
| 106 | +completely. But in exchange, it only allows a known constant size of memory to | |
| 107 | +be reserved, such that verifier can verify that BPF program can't access memory | |
| 108 | +outside its reserved record space. bpf_ringbuf_output(), while slightly slower | |
| 109 | +due to extra memory copy, covers some use cases that are not suitable for | |
| 110 | +``bpf_ringbuf_reserve()``. | |
| 111 | + | |
| 112 | +The difference between commit and discard is very small. Discard just marks | |
| 113 | +a record as discarded, and such records are supposed to be ignored by consumer | |
| 114 | +code. Discard is useful for some advanced use-cases, such as ensuring | |
| 115 | +all-or-nothing multi-record submission, or emulating temporary | |
| 116 | +``malloc()``/``free()`` within single BPF program invocation. | |
| 117 | + | |
| 118 | +Each reserved record is tracked by verifier through existing | |
| 119 | +reference-tracking logic, similar to socket ref-tracking. It is thus | |
| 120 | +impossible to reserve a record, but forget to submit (or discard) it. | |
| 121 | + | |
| 122 | +``bpf_ringbuf_query()`` helper allows to query various properties of ring | |
| 123 | +buffer. Currently 4 are supported: | |
| 124 | + | |
| 125 | +- ``BPF_RB_AVAIL_DATA`` returns amount of unconsumed data in ring buffer; | |
| 126 | +- ``BPF_RB_RING_SIZE`` returns the size of ring buffer; | |
| 127 | +- ``BPF_RB_CONS_POS``/``BPF_RB_PROD_POS`` returns current logical possition | |
| 128 | + of consumer/producer, respectively. | |
| 129 | + | |
| 130 | +Returned values are momentarily snapshots of ring buffer state and could be | |
| 131 | +off by the time helper returns, so this should be used only for | |
| 132 | +debugging/reporting reasons or for implementing various heuristics, that take | |
| 133 | +into account highly-changeable nature of some of those characteristics. | |
| 134 | + | |
| 135 | +One such heuristic might involve more fine-grained control over poll/epoll | |
| 136 | +notifications about new data availability in ring buffer. Together with | |
| 137 | +``BPF_RB_NO_WAKEUP``/``BPF_RB_FORCE_WAKEUP`` flags for output/commit/discard | |
| 138 | +helpers, it allows BPF program a high degree of control and, e.g., more | |
| 139 | +efficient batched notifications. Default self-balancing strategy, though, | |
| 140 | +should be adequate for most applications and will work reliable and efficiently | |
| 141 | +already. | |
| 142 | + | |
| 143 | +Design and Implementation | |
| 144 | +------------------------- | |
| 145 | + | |
| 146 | +This reserve/commit schema allows a natural way for multiple producers, either | |
| 147 | +on different CPUs or even on the same CPU/in the same BPF program, to reserve | |
| 148 | +independent records and work with them without blocking other producers. This | |
| 149 | +means that if BPF program was interruped by another BPF program sharing the | |
| 150 | +same ring buffer, they will both get a record reserved (provided there is | |
| 151 | +enough space left) and can work with it and submit it independently. This | |
| 152 | +applies to NMI context as well, except that due to using a spinlock during | |
| 153 | +reservation, in NMI context, ``bpf_ringbuf_reserve()`` might fail to get | |
| 154 | +a lock, in which case reservation will fail even if ring buffer is not full. | |
| 155 | + | |
| 156 | +The ring buffer itself internally is implemented as a power-of-2 sized | |
| 157 | +circular buffer, with two logical and ever-increasing counters (which might | |
| 158 | +wrap around on 32-bit architectures, that's not a problem): | |
| 159 | + | |
| 160 | +- consumer counter shows up to which logical position consumer consumed the | |
| 161 | + data; | |
| 162 | +- producer counter denotes amount of data reserved by all producers. | |
| 163 | + | |
| 164 | +Each time a record is reserved, producer that "owns" the record will | |
| 165 | +successfully advance producer counter. At that point, data is still not yet | |
| 166 | +ready to be consumed, though. Each record has 8 byte header, which contains the | |
| 167 | +length of reserved record, as well as two extra bits: busy bit to denote that | |
| 168 | +record is still being worked on, and discard bit, which might be set at commit | |
| 169 | +time if record is discarded. In the latter case, consumer is supposed to skip | |
| 170 | +the record and move on to the next one. Record header also encodes record's | |
| 171 | +relative offset from the beginning of ring buffer data area (in pages). This | |
| 172 | +allows ``bpf_ringbuf_commit()``/``bpf_ringbuf_discard()`` to accept only the | |
| 173 | +pointer to the record itself, without requiring also the pointer to ring buffer | |
| 174 | +itself. Ring buffer memory location will be restored from record metadata | |
| 175 | +header. This significantly simplifies verifier, as well as improving API | |
| 176 | +usability. | |
| 177 | + | |
| 178 | +Producer counter increments are serialized under spinlock, so there is | |
| 179 | +a strict ordering between reservations. Commits, on the other hand, are | |
| 180 | +completely lockless and independent. All records become available to consumer | |
| 181 | +in the order of reservations, but only after all previous records where | |
| 182 | +already committed. It is thus possible for slow producers to temporarily hold | |
| 183 | +off submitted records, that were reserved later. | |
| 184 | + | |
| 185 | +Reservation/commit/consumer protocol is verified by litmus tests in | |
| 186 | +Documentation/litmus_tests/bpf-rb/_. | |
| 187 | + | |
| 188 | +One interesting implementation bit, that significantly simplifies (and thus | |
| 189 | +speeds up as well) implementation of both producers and consumers is how data | |
| 190 | +area is mapped twice contiguously back-to-back in the virtual memory. This | |
| 191 | +allows to not take any special measures for samples that have to wrap around | |
| 192 | +at the end of the circular buffer data area, because the next page after the | |
| 193 | +last data page would be first data page again, and thus the sample will still | |
| 194 | +appear completely contiguous in virtual memory. See comment and a simple ASCII | |
| 195 | +diagram showing this visually in ``bpf_ringbuf_area_alloc()``. | |
| 196 | + | |
| 197 | +Another feature that distinguishes BPF ringbuf from perf ring buffer is | |
| 198 | +a self-pacing notifications of new data being availability. | |
| 199 | +``bpf_ringbuf_commit()`` implementation will send a notification of new record | |
| 200 | +being available after commit only if consumer has already caught up right up to | |
| 201 | +the record being committed. If not, consumer still has to catch up and thus | |
| 202 | +will see new data anyways without needing an extra poll notification. | |
| 203 | +Benchmarks (see tools/testing/selftests/bpf/benchs/bench_ringbuf.c_) show that | |
| 204 | +this allows to achieve a very high throughput without having to resort to | |
| 205 | +tricks like "notify only every Nth sample", which are necessary with perf | |
| 206 | +buffer. For extreme cases, when BPF program wants more manual control of | |
| 207 | +notifications, commit/discard/output helpers accept ``BPF_RB_NO_WAKEUP`` and | |
| 208 | +``BPF_RB_FORCE_WAKEUP`` flags, which give full control over notifications of | |
| 209 | +data availability, but require extra caution and diligence in using this API. | |
| @@ -301,7 +301,8 @@ Helpers · 300 unmodified lines | ||
| 301 | 301 | |
| 302 | 302 | .. kernel-doc:: tools/testing/selftests/kselftest_harness.h |
| 303 | 303 | :functions: TH_LOG TEST TEST_SIGNAL FIXTURE FIXTURE_DATA FIXTURE_SETUP |
| 304 | − FIXTURE_TEARDOWN TEST_F TEST_HARNESS_MAIN | |
| 304 | + FIXTURE_TEARDOWN TEST_F TEST_HARNESS_MAIN FIXTURE_VARIANT | |
| 305 | + FIXTURE_VARIANT_ADD | |
| 305 | 306 | |
| 306 | 307 | Operators |
| 307 | 308 | --------- |
| @@ -1,36 +0,0 @@ | ||
| 1 | −Mediatek pericfg controller | |
| 2 | −=========================== | |
| 3 | − | |
| 4 | −The Mediatek pericfg controller provides various clocks and reset | |
| 5 | −outputs to the system. | |
| 6 | − | |
| 7 | −Required Properties: | |
| 8 | − | |
| 9 | −- compatible: Should be one of: | |
| 10 | − - "mediatek,mt2701-pericfg", "syscon" | |
| 11 | − - "mediatek,mt2712-pericfg", "syscon" | |
| 12 | − - "mediatek,mt7622-pericfg", "syscon" | |
| 13 | − - "mediatek,mt7623-pericfg", "mediatek,mt2701-pericfg", "syscon" | |
| 14 | − - "mediatek,mt7629-pericfg", "syscon" | |
| 15 | − - "mediatek,mt8135-pericfg", "syscon" | |
| 16 | − - "mediatek,mt8173-pericfg", "syscon" | |
| 17 | − - "mediatek,mt8183-pericfg", "syscon" | |
| 18 | −- #clock-cells: Must be 1 | |
| 19 | −- #reset-cells: Must be 1 | |
| 20 | − | |
| 21 | −The pericfg controller uses the common clk binding from | |
| 22 | −Documentation/devicetree/bindings/clock/clock-bindings.txt | |
| 23 | −The available clocks are defined in dt-bindings/clock/mt*-clk.h. | |
| 24 | −Also it uses the common reset controller binding from | |
| 25 | −Documentation/devicetree/bindings/reset/reset.txt. | |
| 26 | −The available reset outputs are defined in | |
| 27 | −dt-bindings/reset/mt*-resets.h | |
| 28 | − | |
| 29 | −Example: | |
| 30 | − | |
| 31 | −pericfg: power-controller@10003000 { | |
| 32 | − compatible = "mediatek,mt8173-pericfg", "syscon"; | |
| 33 | − reg = <0 0x10003000 0 0x1000>; | |
| 34 | − #clock-cells = <1>; | |
| 35 | − #reset-cells = <1>; | |
| 36 | −}; | |
| @@ -0,0 +1,64 @@ | ||
| 1 | +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) | |
| 2 | +%YAML 1.2 | |
| 3 | +--- | |
| 4 | +$id: "http://devicetree.org/schemas/arm/mediatek/mediatek,pericfg.yaml#" | |
| 5 | +$schema: "http://devicetree.org/meta-schemas/core.yaml#" | |
| 6 | + | |
| 7 | +title: MediaTek Peripheral Configuration Controller | |
| 8 | + | |
| 9 | +maintainers: | |
| 10 | + - Bartosz Golaszewski <bgolaszewski@baylibre.com> | |
| 11 | + | |
| 12 | +description: | |
| 13 | + The Mediatek pericfg controller provides various clocks and reset outputs | |
| 14 | + to the system. | |
| 15 | + | |
| 16 | +properties: | |
| 17 | + compatible: | |
| 18 | + oneOf: | |
| 19 | + - items: | |
| 20 | + - enum: | |
| 21 | + - mediatek,mt2701-pericfg | |
| 22 | + - mediatek,mt2712-pericfg | |
| 23 | + - mediatek,mt7622-pericfg | |
| 24 | + - mediatek,mt7629-pericfg | |
| 25 | + - mediatek,mt8135-pericfg | |
| 26 | + - mediatek,mt8173-pericfg | |
| 27 | + - mediatek,mt8183-pericfg | |
| 28 | + - mediatek,mt8516-pericfg | |
| 29 | + - const: syscon | |
| 30 | + - items: | |
| 31 | + # Special case for mt7623 for backward compatibility | |
| 32 | + - const: mediatek,mt7623-pericfg | |
| 33 | + - const: mediatek,mt2701-pericfg | |
| 34 | + - const: syscon | |
| 35 | + | |
| 36 | + reg: | |
| 37 | + maxItems: 1 | |
| 38 | + | |
| 39 | + '#clock-cells': | |
| 40 | + const: 1 | |
| 41 | + | |
| 42 | + '#reset-cells': | |
| 43 | + const: 1 | |
| 44 | + | |
| 45 | +required: | |
| 46 | + - compatible | |
| 47 | + - reg | |
| 48 | + | |
| 49 | +examples: | |
| 50 | + - | | |
| 51 | + pericfg@10003000 { | |
| 52 | + compatible = "mediatek,mt8173-pericfg", "syscon"; | |
| 53 | + reg = <0x10003000 0x1000>; | |
| 54 | + #clock-cells = <1>; | |
| 55 | + #reset-cells = <1>; | |
| 56 | + }; | |
| 57 | + | |
| 58 | + - | | |
| 59 | + pericfg@10003000 { | |
| 60 | + compatible = "mediatek,mt7623-pericfg", "mediatek,mt2701-pericfg", "syscon"; | |
| 61 | + reg = <0x10003000 0x1000>; | |
| 62 | + #clock-cells = <1>; | |
| 63 | + #reset-cells = <1>; | |
| 64 | + }; | |
| @@ -40,18 +40,22 @@ allOf: · 39 unmodified lines | ||
| 40 | 40 | then: |
| 41 | 41 | properties: |
| 42 | 42 | clocks: |
| 43 | + minItems: 3 | |
| 44 | + maxItems: 4 | |
| 43 | 45 | items: |
| 44 | 46 | - description: GMAC main clock |
| 45 | 47 | - description: First parent clock of the internal mux |
| 46 | 48 | - description: Second parent clock of the internal mux |
| 49 | + - description: The clock which drives the timing adjustment logic | |
| 47 | 50 | |
| 48 | 51 | clock-names: |
| 49 | 52 | minItems: 3 |
| 50 | − maxItems: 3 | |
| 53 | + maxItems: 4 | |
| 51 | 54 | items: |
| 52 | 55 | - const: stmmaceth |
| 53 | 56 | - const: clkin0 |
| 54 | 57 | - const: clkin1 |
| 58 | + - const: timing-adjustment | |
| 55 | 59 | |
| 56 | 60 | amlogic,tx-delay-ns: |
| 57 | 61 | $ref: /schemas/types.yaml#definitions/uint32 |
| @@ -67,6 +71,19 @@ allOf: · 9 unmodified lines | ||
| 67 | 71 | PHY and MAC are adding a delay). |
| 68 | 72 | Any configuration is ignored when the phy-mode is set to "rmii". |
| 69 | 73 | |
| 74 | + amlogic,rx-delay-ns: | |
| 75 | + enum: | |
| 76 | + - 0 | |
| 77 | + - 2 | |
| 78 | + default: 0 | |
| 79 | + description: | |
| 80 | + The internal RGMII RX clock delay (provided by this IP block) in | |
| 81 | + nanoseconds. When phy-mode is set to "rgmii" then the RX delay | |
| 82 | + should be explicitly configured. When the phy-mode is set to | |
| 83 | + either "rgmii-id" or "rgmii-rxid" the RX clock delay is already | |
| 84 | + provided by the PHY. Any configuration is ignored when the | |
| 85 | + phy-mode is set to "rmii". | |
| 86 | + | |
| 70 | 87 | properties: |
| 71 | 88 | compatible: |
| 72 | 89 | additionalItems: true |
| @@ -107,7 +124,7 @@ examples: · 34 unmodified lines | ||
| 107 | 124 | reg = <0xc9410000 0x10000>, <0xc8834540 0x8>; |
| 108 | 125 | interrupts = <8>; |
| 109 | 126 | interrupt-names = "macirq"; |
| 110 | − clocks = <&clk_eth>, <&clkc_fclk_div2>, <&clk_mpll2>; | |
| 111 | − clock-names = "stmmaceth", "clkin0", "clkin1"; | |
| 127 | + clocks = <&clk_eth>, <&clk_fclk_div2>, <&clk_mpll2>, <&clk_fclk_div2>; | |
| 128 | + clock-names = "stmmaceth", "clkin0", "clkin1", "timing-adjustment"; | |
| 112 | 129 | phy-mode = "rgmii"; |
| 113 | 130 | }; |
| @@ -81,7 +81,8 @@ properties: · 80 unmodified lines | ||
| 81 | 81 | $ref: /schemas/types.yaml#definitions/flag |
| 82 | 82 | description: |
| 83 | 83 | If set, indicates the PHY device does not correctly release |
| 84 | − the turn around line low at the end of a MDIO transaction. | |
| 84 | + the turn around line low at end of the control phase of the | |
| 85 | + MDIO transaction. | |
| 85 | 86 | |
| 86 | 87 | enet-phy-lane-swap: |
| 87 | 88 | $ref: /schemas/types.yaml#definitions/flag |
| @@ -22,8 +22,11 @@ Optional properties: · 21 unmodified lines | ||
| 22 | 22 | - fsl,err006687-workaround-present: If present indicates that the system has |
| 23 | 23 | the hardware workaround for ERR006687 applied and does not need a software |
| 24 | 24 | workaround. |
| 25 | −- gpr: phandle of SoC general purpose register mode. Required for wake on LAN | |
| 26 | − on some SoCs | |
| 25 | +- fsl,stop-mode: register bits of stop mode control, the format is | |
| 26 | + <&gpr req_gpr req_bit>. | |
| 27 | + gpr is the phandle to general purpose register node. | |
| 28 | + req_gpr is the gpr register offset for ENET stop request. | |
| 29 | + req_bit is the gpr bit offset for ENET stop request. | |
| 27 | 30 | -interrupt-names: names of the interrupts listed in interrupts property in |
| 28 | 31 | the same order. The defaults if not specified are |
| 29 | 32 | __Number of interrupts__ __Default__ |
| @@ -82,6 +85,7 @@ ethernet@83fec000 { · 52 unmodified lines | ||
| 82 | 85 | phy-supply = <®_fec_supply>; |
| 83 | 86 | phy-handle = <ðphy>; |
| 84 | 87 | mdio { |
| 88 | + clock-frequency = <5000000>; | |
| 85 | 89 | ethphy: ethernet-phy@6 { |
| 86 | 90 | compatible = "ethernet-phy-ieee802.3-c22"; |
| 87 | 91 | reg = <6>; |
| @@ -0,0 +1,56 @@ | ||
| 1 | +IMX8 glue layer controller, NXP imx8 families support Synopsys MAC 5.10a IP. | |
| 2 | + | |
| 3 | +This file documents platform glue layer for IMX. | |
| 4 | +Please see stmmac.txt for the other unchanged properties. | |
| 5 | + | |
| 6 | +The device node has following properties. | |
| 7 | + | |
| 8 | +Required properties: | |
| 9 | +- compatible: Should be "nxp,imx8mp-dwmac-eqos" to select glue layer | |
| 10 | + and "snps,dwmac-5.10a" to select IP version. | |
| 11 | +- clocks: Must contain a phandle for each entry in clock-names. | |
| 12 | +- clock-names: Should be "stmmaceth" for the host clock. | |
| 13 | + Should be "pclk" for the MAC apb clock. | |
| 14 | + Should be "ptp_ref" for the MAC timer clock. | |
| 15 | + Should be "tx" for the MAC RGMII TX clock: | |
| 16 | + Should be "mem" for EQOS MEM clock. | |
| 17 | + - "mem" clock is required for imx8dxl platform. | |
| 18 | + - "mem" clock is not required for imx8mp platform. | |
| 19 | +- interrupt-names: Should contain a list of interrupt names corresponding to | |
| 20 | + the interrupts in the interrupts property, if available. | |
| 21 | + Should be "macirq" for the main MAC IRQ | |
| 22 | + Should be "eth_wake_irq" for the IT which wake up system | |
| 23 | +- intf_mode: Should be phandle/offset pair. The phandle to the syscon node which | |
| 24 | + encompases the GPR register, and the offset of the GPR register. | |
| 25 | + - required for imx8mp platform. | |
| 26 | + - is optional for imx8dxl platform. | |
| 27 | + | |
| 28 | +Optional properties: | |
| 29 | +- intf_mode: is optional for imx8dxl platform. | |
| 30 | +- snps,rmii_refclk_ext: to select RMII reference clock from external. | |
| 31 | + | |
| 32 | +Example: | |
| 33 | + eqos: ethernet@30bf0000 { | |
| 34 | + compatible = "nxp,imx8mp-dwmac-eqos", "snps,dwmac-5.10a"; | |
| 35 | + reg = <0x30bf0000 0x10000>; | |
| 36 | + interrupts = <GIC_SPI 134 IRQ_TYPE_LEVEL_HIGH>, | |
| 37 | + <GIC_SPI 135 IRQ_TYPE_LEVEL_HIGH>; | |
| 38 | + interrupt-names = "eth_wake_irq", "macirq"; | |
| 39 | + clocks = <&clk IMX8MP_CLK_ENET_QOS_ROOT>, | |
| 40 | + <&clk IMX8MP_CLK_QOS_ENET_ROOT>, | |
| 41 | + <&clk IMX8MP_CLK_ENET_QOS_TIMER>, | |
| 42 | + <&clk IMX8MP_CLK_ENET_QOS>; | |
| 43 | + clock-names = "stmmaceth", "pclk", "ptp_ref", "tx"; | |
| 44 | + assigned-clocks = <&clk IMX8MP_CLK_ENET_AXI>, | |
| 45 | + <&clk IMX8MP_CLK_ENET_QOS_TIMER>, | |
| 46 | + <&clk IMX8MP_CLK_ENET_QOS>; | |
| 47 | + assigned-clock-parents = <&clk IMX8MP_SYS_PLL1_266M>, | |
| 48 | + <&clk IMX8MP_SYS_PLL2_100M>, | |
| 49 | + <&clk IMX8MP_SYS_PLL2_125M>; | |
| 50 | + assigned-clock-rates = <0>, <100000000>, <125000000>; | |
| 51 | + nvmem-cells = <ð_mac0>; | |
| 52 | + nvmem-cell-names = "mac-address"; | |
| 53 | + nvmem_macaddr_swap; | |
| 54 | + intf_mode = <&gpr 0x4>; | |
| 55 | + status = "disabled"; | |
| 56 | + }; | |
| @@ -31,13 +31,25 @@ properties: · 30 unmodified lines | ||
| 31 | 31 | maxItems: 1 |
| 32 | 32 | description: |
| 33 | 33 | The phandle and specifier for the GPIO that controls the RESET |
| 34 | − lines of all PHYs on that MDIO bus. | |
| 34 | + lines of all devices on that MDIO bus. | |
| 35 | 35 | |
| 36 | 36 | reset-delay-us: |
| 37 | 37 | description: |
| 38 | − RESET pulse width in microseconds. It applies to all PHY devices | |
| 39 | − and must therefore be appropriately determined based on all PHY | |
| 40 | − requirements (maximum value of all per-PHY RESET pulse widths). | |
| 38 | + RESET pulse width in microseconds. It applies to all MDIO devices | |
| 39 | + and must therefore be appropriately determined based on all devices | |
| 40 | + requirements (maximum value of all per-device RESET pulse widths). | |
| 41 | + | |
| 42 | + clock-frequency: | |
| 43 | + description: | |
| 44 | + Desired MDIO bus clock frequency in Hz. Values greater than IEEE 802.3 | |
| 45 | + defined 2.5MHz should only be used when all devices on the bus support | |
| 46 | + the given clock speed. | |
| 47 | + | |
| 48 | + suppress-preamble: | |
| 49 | + description: | |
| 50 | + The 32 bit preamble should be suppressed. In order for this to | |
| 51 | + work, all devices on the bus must support suppressed preamble. | |
| 52 | + type: boolean | |
| 41 | 53 | |
| 42 | 54 | patternProperties: |
| 43 | 55 | "^ethernet-phy@[0-9a-f]+$": |
| @@ -48,7 +60,35 @@ patternProperties: · 4 unmodified lines | ||
| 48 | 60 | minimum: 0 |
| 49 | 61 | maximum: 31 |
| 50 | 62 | description: |
| 51 | − The ID number for the PHY. | |
| 63 | + The ID number for the device. | |
| 64 | + | |
| 65 | + broken-turn-around: | |
| 66 | + $ref: /schemas/types.yaml#definitions/flag | |
| 67 | + description: | |
| 68 | + If set, indicates the MDIO device does not correctly release | |
| 69 | + the turn around line low at end of the control phase of the | |
| 70 | + MDIO transaction. | |
| 71 | + | |
| 72 | + resets: | |
| 73 | + maxItems: 1 | |
| 74 | + | |
| 75 | + reset-names: | |
| 76 | + const: phy | |
| 77 | + | |
| 78 | + reset-gpios: | |
| 79 | + maxItems: 1 | |
| 80 | + description: | |
| 81 | + The GPIO phandle and specifier for the MDIO reset signal. | |
| 82 | + | |
| 83 | + reset-assert-us: | |
| 84 | + description: | |
| 85 | + Delay after the reset was asserted in microseconds. If this | |
| 86 | + property is missing the delay will be skipped. | |
| 87 | + | |
| 88 | + reset-deassert-us: | |
| 89 | + description: | |
| 90 | + Delay after the reset was deasserted in microseconds. If | |
| 91 | + this property is missing the delay will be skipped. | |
| 52 | 92 | |
| 53 | 93 | required: |
| 54 | 94 | - reg |
| @@ -0,0 +1,89 @@ | ||
| 1 | +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) | |
| 2 | +%YAML 1.2 | |
| 3 | +--- | |
| 4 | +$id: http://devicetree.org/schemas/net/mediatek,star-emac.yaml# | |
| 5 | +$schema: http://devicetree.org/meta-schemas/core.yaml# | |
| 6 | + | |
| 7 | +title: MediaTek STAR Ethernet MAC Controller | |
| 8 | + | |
| 9 | +maintainers: | |
| 10 | + - Bartosz Golaszewski <bgolaszewski@baylibre.com> | |
| 11 | + | |
| 12 | +description: | |
| 13 | + This Ethernet MAC is used on the MT8* family of SoCs from MediaTek. | |
| 14 | + It's compliant with 802.3 standards and supports half- and full-duplex | |
| 15 | + modes with flow-control as well as CRC offloading and VLAN tags. | |
| 16 | + | |
| 17 | +allOf: | |
| 18 | + - $ref: "ethernet-controller.yaml#" | |
| 19 | + | |
| 20 | +properties: | |
| 21 | + compatible: | |
| 22 | + enum: | |
| 23 | + - mediatek,mt8516-eth | |
| 24 | + - mediatek,mt8518-eth | |
| 25 | + - mediatek,mt8175-eth | |
| 26 | + | |
| 27 | + reg: | |
| 28 | + maxItems: 1 | |
| 29 | + | |
| 30 | + interrupts: | |
| 31 | + maxItems: 1 | |
| 32 | + | |
| 33 | + clocks: | |
| 34 | + minItems: 3 | |
| 35 | + maxItems: 3 | |
| 36 | + | |
| 37 | + clock-names: | |
| 38 | + additionalItems: false | |
| 39 | + items: | |
| 40 | + - const: core | |
| 41 | + - const: reg | |
| 42 | + - const: trans | |
| 43 | + | |
| 44 | + mediatek,pericfg: | |
| 45 | + $ref: /schemas/types.yaml#definitions/phandle | |
| 46 | + description: | |
| 47 | + Phandle to the device containing the PERICFG register range. This is used | |
| 48 | + to control the MII mode. | |
| 49 | + | |
| 50 | + mdio: | |
| 51 | + type: object | |
| 52 | + description: | |
| 53 | + Creates and registers an MDIO bus. | |
| 54 | + | |
| 55 | +required: | |
| 56 | + - compatible | |
| 57 | + - reg | |
| 58 | + - interrupts | |
| 59 | + - clocks | |
| 60 | + - clock-names | |
| 61 | + - mediatek,pericfg | |
| 62 | + - phy-handle | |
| 63 | + | |
| 64 | +examples: | |
| 65 | + - | | |
| 66 | + #include <dt-bindings/interrupt-controller/arm-gic.h> | |
| 67 | + #include <dt-bindings/clock/mt8516-clk.h> | |
| 68 | + | |
| 69 | + ethernet: ethernet@11180000 { | |
| 70 | + compatible = "mediatek,mt8516-eth"; | |
| 71 | + reg = <0x11180000 0x1000>; | |
| 72 | + mediatek,pericfg = <&pericfg>; | |
| 73 | + interrupts = <GIC_SPI 111 IRQ_TYPE_LEVEL_LOW>; | |
| 74 | + clocks = <&topckgen CLK_TOP_RG_ETH>, | |
| 75 | + <&topckgen CLK_TOP_66M_ETH>, | |
| 76 | + <&topckgen CLK_TOP_133M_ETH>; | |
| 77 | + clock-names = "core", "reg", "trans"; | |
| 78 | + phy-handle = <ð_phy>; | |
| 79 | + phy-mode = "rmii"; | |
| 80 | + | |
| 81 | + mdio { | |
| 82 | + #address-cells = <1>; | |
| 83 | + #size-cells = <0>; | |
| 84 | + | |
| 85 | + eth_phy: ethernet-phy@0 { | |
| 86 | + reg = <0>; | |
| 87 | + }; | |
| 88 | + }; | |
| 89 | + }; | |
| @@ -0,0 +1,61 @@ | ||
| 1 | +# SPDX-License-Identifier: GPL-2.0+ | |
| 2 | +%YAML 1.2 | |
| 3 | +--- | |
| 4 | +$id: http://devicetree.org/schemas/net/nxp,tja11xx.yaml# | |
| 5 | +$schema: http://devicetree.org/meta-schemas/core.yaml# | |
| 6 | + | |
| 7 | +title: NXP TJA11xx PHY | |
| 8 | + | |
| 9 | +maintainers: | |
| 10 | + - Andrew Lunn <andrew@lunn.ch> | |
| 11 | + - Florian Fainelli <f.fainelli@gmail.com> | |
| 12 | + - Heiner Kallweit <hkallweit1@gmail.com> | |
| 13 | + | |
| 14 | +description: | |
| 15 | + Bindings for NXP TJA11xx automotive PHYs | |
| 16 | + | |
| 17 | +allOf: | |
| 18 | + - $ref: ethernet-phy.yaml# | |
| 19 | + | |
| 20 | +patternProperties: | |
| 21 | + "^ethernet-phy@[0-9a-f]+$": | |
| 22 | + type: object | |
| 23 | + description: | | |
| 24 | + Some packages have multiple PHYs. Secondary PHY should be defines as | |
| 25 | + subnode of the first (parent) PHY. | |
| 26 | + | |
| 27 | + properties: | |
| 28 | + reg: | |
| 29 | + minimum: 0 | |
| 30 | + maximum: 31 | |
| 31 | + description: | |
| 32 | + The ID number for the child PHY. Should be +1 of parent PHY. | |
| 33 | + | |
| 34 | + required: | |
| 35 | + - reg | |
| 36 | + | |
| 37 | +examples: | |
| 38 | + - | | |
| 39 | + mdio { | |
| 40 | + #address-cells = <1>; | |
| 41 | + #size-cells = <0>; | |
| 42 | + | |
| 43 | + tja1101_phy0: ethernet-phy@4 { | |
| 44 | + reg = <0x4>; | |
| 45 | + }; | |
| 46 | + }; | |
| 47 | + - | | |
| 48 | + mdio { | |
| 49 | + #address-cells = <1>; | |
| 50 | + #size-cells = <0>; | |
| 51 | + | |
| 52 | + tja1102_phy0: ethernet-phy@4 { | |
| 53 | + reg = <0x4>; | |
| 54 | + #address-cells = <1>; | |
| 55 | + #size-cells = <0>; | |
| 56 | + | |
| 57 | + tja1102_phy1: ethernet-phy@5 { | |
| 58 | + reg = <0x5>; | |
| 59 | + }; | |
| 60 | + }; | |
| 61 | + }; | |
| @@ -1,45 +0,0 @@ | ||
| 1 | −Required properties: | |
| 2 | −- compatible: Should be "qca,<soc>-eth". Currently support compatibles are: | |
| 3 | − qca,ar7100-eth - Atheros AR7100 | |
| 4 | − qca,ar7240-eth - Atheros AR7240 | |
| 5 | − qca,ar7241-eth - Atheros AR7241 | |
| 6 | − qca,ar7242-eth - Atheros AR7242 | |
| 7 | − qca,ar9130-eth - Atheros AR9130 | |
| 8 | − qca,ar9330-eth - Atheros AR9330 | |
| 9 | − qca,ar9340-eth - Atheros AR9340 | |
| 10 | − qca,qca9530-eth - Qualcomm Atheros QCA9530 | |
| 11 | − qca,qca9550-eth - Qualcomm Atheros QCA9550 | |
| 12 | − qca,qca9560-eth - Qualcomm Atheros QCA9560 | |
| 13 | − | |
| 14 | −- reg : Address and length of the register set for the device | |
| 15 | −- interrupts : Should contain eth interrupt | |
| 16 | −- phy-mode : See ethernet.txt file in the same directory | |
| 17 | −- clocks: the clock used by the core | |
| 18 | −- clock-names: the names of the clock listed in the clocks property. These are | |
| 19 | − "eth" and "mdio". | |
| 20 | −- resets: Should contain phandles to the reset signals | |
| 21 | −- reset-names: Should contain the names of reset signal listed in the resets | |
| 22 | − property. These are "mac" and "mdio" | |
| 23 | − | |
| 24 | −Optional properties: | |
| 25 | −- phy-handle : phandle to the PHY device connected to this device. | |
| 26 | −- fixed-link : Assume a fixed link. See fixed-link.txt in the same directory. | |
| 27 | − Use instead of phy-handle. | |
| 28 | − | |
| 29 | −Optional subnodes: | |
| 30 | −- mdio : specifies the mdio bus, used as a container for phy nodes | |
| 31 | − according to phy.txt in the same directory | |
| 32 | − | |
| 33 | −Example: | |
| 34 | − | |
| 35 | −ethernet@1a000000 { | |
| 36 | − compatible = "qca,ar9330-eth"; | |
| 37 | − reg = <0x1a000000 0x200>; | |
| 38 | − interrupts = <5>; | |
| 39 | − resets = <&rst 13>, <&rst 23>; | |
| 40 | − reset-names = "mac", "mdio"; | |
| 41 | − clocks = <&pll ATH79_CLK_AHB>, <&pll ATH79_CLK_MDIO>; | |
| 42 | − clock-names = "eth", "mdio"; | |
| 43 | − | |
| 44 | − phy-mode = "gmii"; | |
| 45 | −}; | |
| @@ -0,0 +1,216 @@ | ||
| 1 | +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) | |
| 2 | +%YAML 1.2 | |
| 3 | +--- | |
| 4 | +$id: http://devicetree.org/schemas/net/qca,ar71xx.yaml# | |
| 5 | +$schema: http://devicetree.org/meta-schemas/core.yaml# | |
| 6 | + | |
| 7 | +title: QCA AR71XX MAC | |
| 8 | + | |
| 9 | +allOf: | |
| 10 | + - $ref: ethernet-controller.yaml# | |
| 11 | + | |
| 12 | +maintainers: | |
| 13 | + - Oleksij Rempel <o.rempel@pengutronix.de> | |
| 14 | + | |
| 15 | +properties: | |
| 16 | + compatible: | |
| 17 | + oneOf: | |
| 18 | + - items: | |
| 19 | + - enum: | |
| 20 | + - qca,ar7100-eth # Atheros AR7100 | |
| 21 | + - qca,ar7240-eth # Atheros AR7240 | |
| 22 | + - qca,ar7241-eth # Atheros AR7241 | |
| 23 | + - qca,ar7242-eth # Atheros AR7242 | |
| 24 | + - qca,ar9130-eth # Atheros AR9130 | |
| 25 | + - qca,ar9330-eth # Atheros AR9330 | |
| 26 | + - qca,ar9340-eth # Atheros AR9340 | |
| 27 | + - qca,qca9530-eth # Qualcomm Atheros QCA9530 | |
| 28 | + - qca,qca9550-eth # Qualcomm Atheros QCA9550 | |
| 29 | + - qca,qca9560-eth # Qualcomm Atheros QCA9560 | |
| 30 | + | |
| 31 | + reg: | |
| 32 | + maxItems: 1 | |
| 33 | + | |
| 34 | + interrupts: | |
| 35 | + maxItems: 1 | |
| 36 | + | |
| 37 | + '#address-cells': | |
| 38 | + description: number of address cells for the MDIO bus | |
| 39 | + const: 1 | |
| 40 | + | |
| 41 | + '#size-cells': | |
| 42 | + description: number of size cells on the MDIO bus | |
| 43 | + const: 0 | |
| 44 | + | |
| 45 | + clocks: | |
| 46 | + items: | |
| 47 | + - description: MAC main clock | |
| 48 | + - description: MDIO clock | |
| 49 | + | |
| 50 | + clock-names: | |
| 51 | + items: | |
| 52 | + - const: eth | |
| 53 | + - const: mdio | |
| 54 | + | |
| 55 | + resets: | |
| 56 | + items: | |
| 57 | + - description: MAC reset | |
| 58 | + - description: MDIO reset | |
| 59 | + | |
| 60 | + reset-names: | |
| 61 | + items: | |
| 62 | + - const: mac | |
| 63 | + - const: mdio | |
| 64 | + | |
| 65 | +required: | |
| 66 | + - compatible | |
| 67 | + - reg | |
| 68 | + - interrupts | |
| 69 | + - phy-mode | |
| 70 | + - clocks | |
| 71 | + - clock-names | |
| 72 | + - resets | |
| 73 | + - reset-names | |
| 74 | + | |
| 75 | +examples: | |
| 76 | + # Lager board | |
| 77 | + - | | |
| 78 | + eth0: ethernet@19000000 { | |
| 79 | + compatible = "qca,ar9330-eth"; | |
| 80 | + reg = <0x19000000 0x200>; | |
| 81 | + interrupts = <4>; | |
| 82 | + resets = <&rst 9>, <&rst 22>; | |
| 83 | + reset-names = "mac", "mdio"; | |
| 84 | + clocks = <&pll 1>, <&pll 2>; | |
| 85 | + clock-names = "eth", "mdio"; | |
| 86 | + qca,ethcfg = <ðcfg>; | |
| 87 | + phy-mode = "mii"; | |
| 88 | + phy-handle = <&phy_port4>; | |
| 89 | + }; | |
| 90 | + | |
| 91 | + eth1: ethernet@1a000000 { | |
| 92 | + compatible = "qca,ar9330-eth"; | |
| 93 | + reg = <0x1a000000 0x200>; | |
| 94 | + interrupts = <5>; | |
| 95 | + resets = <&rst 13>, <&rst 23>; | |
| 96 | + reset-names = "mac", "mdio"; | |
| 97 | + clocks = <&pll 1>, <&pll 2>; | |
| 98 | + clock-names = "eth", "mdio"; | |
| 99 | + | |
| 100 | + phy-mode = "gmii"; | |
| 101 | + | |
| 102 | + status = "disabled"; | |
| 103 | + | |
| 104 | + fixed-link { | |
| 105 | + speed = <1000>; | |
| 106 | + full-duplex; | |
| 107 | + }; | |
| 108 | + | |
| 109 | + mdio { | |
| 110 | + #address-cells = <1>; | |
| 111 | + #size-cells = <0>; | |
| 112 | + | |
| 113 | + switch10: switch@10 { | |
| 114 | + #address-cells = <1>; | |
| 115 | + #size-cells = <0>; | |
| 116 | + | |
| 117 | + compatible = "qca,ar9331-switch"; | |
| 118 | + reg = <0x10>; | |
| 119 | + resets = <&rst 8>; | |
| 120 | + reset-names = "switch"; | |
| 121 | + | |
| 122 | + interrupt-parent = <&miscintc>; | |
| 123 | + interrupts = <12>; | |
| 124 | + | |
| 125 | + interrupt-controller; | |
| 126 | + #interrupt-cells = <1>; | |
| 127 | + | |
| 128 | + ports { | |
| 129 | + #address-cells = <1>; | |
| 130 | + #size-cells = <0>; | |
| 131 | + | |
| 132 | + switch_port0: port@0 { | |
| 133 | + reg = <0x0>; | |
| 134 | + label = "cpu"; | |
| 135 | + ethernet = <ð1>; | |
| 136 | + | |
| 137 | + phy-mode = "gmii"; | |
| 138 | + | |
| 139 | + fixed-link { | |
| 140 | + speed = <1000>; | |
| 141 | + full-duplex; | |
| 142 | + }; | |
| 143 | + }; | |
| 144 | + | |
| 145 | + switch_port1: port@1 { | |
| 146 | + reg = <0x1>; | |
| 147 | + phy-handle = <&phy_port0>; | |
| 148 | + phy-mode = "internal"; | |
| 149 | + | |
| 150 | + status = "disabled"; | |
| 151 | + }; | |
| 152 | + | |
| 153 | + switch_port2: port@2 { | |
| 154 | + reg = <0x2>; | |
| 155 | + phy-handle = <&phy_port1>; | |
| 156 | + phy-mode = "internal"; | |
| 157 | + | |
| 158 | + status = "disabled"; | |
| 159 | + }; | |
| 160 | + | |
| 161 | + switch_port3: port@3 { | |
| 162 | + reg = <0x3>; | |
| 163 | + phy-handle = <&phy_port2>; | |
| 164 | + phy-mode = "internal"; | |
| 165 | + | |
| 166 | + status = "disabled"; | |
| 167 | + }; | |
| 168 | + | |
| 169 | + switch_port4: port@4 { | |
| 170 | + reg = <0x4>; | |
| 171 | + phy-handle = <&phy_port3>; | |
| 172 | + phy-mode = "internal"; | |
| 173 | + | |
| 174 | + status = "disabled"; | |
| 175 | + }; | |
| 176 | + }; | |
| 177 | + | |
| 178 | + mdio { | |
| 179 | + #address-cells = <1>; | |
| 180 | + #size-cells = <0>; | |
| 181 | + | |
| 182 | + interrupt-parent = <&switch10>; | |
| 183 | + | |
| 184 | + phy_port0: phy@0 { | |
| 185 | + reg = <0x0>; | |
| 186 | + interrupts = <0>; | |
| 187 | + status = "disabled"; | |
| 188 | + }; | |
| 189 | + | |
| 190 | + phy_port1: phy@1 { | |
| 191 | + reg = <0x1>; | |
| 192 | + interrupts = <0>; | |
| 193 | + status = "disabled"; | |
| 194 | + }; | |
| 195 | + | |
| 196 | + phy_port2: phy@2 { | |
| 197 | + reg = <0x2>; | |
| 198 | + interrupts = <0>; | |
| 199 | + status = "disabled"; | |
| 200 | + }; | |
| 201 | + | |
| 202 | + phy_port3: phy@3 { | |
| 203 | + reg = <0x3>; | |
| 204 | + interrupts = <0>; | |
| 205 | + status = "disabled"; | |
| 206 | + }; | |
| 207 | + | |
| 208 | + phy_port4: phy@4 { | |
| 209 | + reg = <0x4>; | |
| 210 | + interrupts = <0>; | |
| 211 | + status = "disabled"; | |
| 212 | + }; | |
| 213 | + }; | |
| 214 | + }; | |
| 215 | + }; | |
| 216 | + }; | |
| @@ -20,7 +20,10 @@ description: · 19 unmodified lines | ||
| 20 | 20 | The GSI is an integral part of the IPA, but it is logically isolated |
| 21 | 21 | and has a distinct interrupt and a separately-defined address space. |
| 22 | 22 | |
| 23 | − See also soc/qcom/qcom,smp2p.txt and interconnect/interconnect.txt. | |
| 23 | + See also soc/qcom/qcom,smp2p.txt and interconnect/interconnect.txt. See | |
| 24 | + iommu/iommu.txt and iommu/arm,smmu.yaml for more information about SMMU | |
| 25 | + bindings. | |
| 26 | + | |
| 24 | 27 | |
| 25 | 28 | - | |
| 26 | 29 | -------- --------- |
| @@ -54,6 +57,9 @@ properties: · 27 unmodified lines | ||
| 54 | 57 | - const: ipa-shared |
| 55 | 58 | - const: gsi |
| 56 | 59 | |
| 60 | + iommus: | |
| 61 | + maxItems: 1 | |
| 62 | + | |
| 57 | 63 | clocks: |
| 58 | 64 | maxItems: 1 |
| 59 | 65 | |
| @@ -126,6 +132,7 @@ properties: · 66 unmodified lines | ||
| 126 | 132 | |
| 127 | 133 | required: |
| 128 | 134 | - compatible |
| 135 | + - iommus | |
| 129 | 136 | - reg |
| 130 | 137 | - clocks |
| 131 | 138 | - interrupts |
| @@ -164,6 +171,7 @@ examples: · 32 unmodified lines | ||
| 164 | 171 | modem-init; |
| 165 | 172 | modem-remoteproc = <&mss_pil>; |
| 166 | 173 | |
| 174 | + iommus = <&apps_smmu 0x720 0x3>; | |
| 167 | 175 | reg = <0 0x1e40000 0 0x7000>, |
| 168 | 176 | <0 0x1e47000 0 0x2000>, |
| 169 | 177 | <0 0x1e04000 0 0x2c000>; |
| @@ -0,0 +1,61 @@ | ||
| 1 | +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause | |
| 2 | +%YAML 1.2 | |
| 3 | +--- | |
| 4 | +$id: http://devicetree.org/schemas/net/qcom,ipq4019-mdio.yaml# | |
| 5 | +$schema: http://devicetree.org/meta-schemas/core.yaml# | |
| 6 | + | |
| 7 | +title: Qualcomm IPQ40xx MDIO Controller Device Tree Bindings | |
| 8 | + | |
| 9 | +maintainers: | |
| 10 | + - Robert Marko <robert.marko@sartura.hr> | |
| 11 | + | |
| 12 | +allOf: | |
| 13 | + - $ref: "mdio.yaml#" | |
| 14 | + | |
| 15 | +properties: | |
| 16 | + compatible: | |
| 17 | + const: qcom,ipq4019-mdio | |
| 18 | + | |
| 19 | + "#address-cells": | |
| 20 | + const: 1 | |
| 21 | + | |
| 22 | + "#size-cells": | |
| 23 | + const: 0 | |
| 24 | + | |
| 25 | + reg: | |
| 26 | + maxItems: 1 | |
| 27 | + | |
| 28 | +required: | |
| 29 | + - compatible | |
| 30 | + - reg | |
| 31 | + - "#address-cells" | |
| 32 | + - "#size-cells" | |
| 33 | + | |
| 34 | +examples: | |
| 35 | + - | | |
| 36 | + mdio@90000 { | |
| 37 | + #address-cells = <1>; | |
| 38 | + #size-cells = <0>; | |
| 39 | + compatible = "qcom,ipq4019-mdio"; | |
| 40 | + reg = <0x90000 0x64>; | |
| 41 | + | |
| 42 | + ethphy0: ethernet-phy@0 { | |
| 43 | + reg = <0>; | |
| 44 | + }; | |
| 45 | + | |
| 46 | + ethphy1: ethernet-phy@1 { | |
| 47 | + reg = <1>; | |
| 48 | + }; | |
| 49 | + | |
| 50 | + ethphy2: ethernet-phy@2 { | |
| 51 | + reg = <2>; | |
| 52 | + }; | |
| 53 | + | |
| 54 | + ethphy3: ethernet-phy@3 { | |
| 55 | + reg = <3>; | |
| 56 | + }; | |
| 57 | + | |
| 58 | + ethphy4: ethernet-phy@4 { | |
| 59 | + reg = <4>; | |
| 60 | + }; | |
| 61 | + }; | |
| @@ -10,9 +10,11 @@ device the slave device is attached to. · 9 unmodified lines | ||
| 10 | 10 | Required properties: |
| 11 | 11 | - compatible: should contain one of the following: |
| 12 | 12 | * "qcom,qca6174-bt" |
| 13 | + * "qcom,qca9377-bt" | |
| 13 | 14 | * "qcom,wcn3990-bt" |
| 14 | 15 | * "qcom,wcn3991-bt" |
| 15 | 16 | * "qcom,wcn3998-bt" |
| 17 | + * "qcom,qca6390-bt" | |
| 16 | 18 | |
| 17 | 19 | Optional properties for compatible string qcom,qca6174-bt: |
| 18 | 20 | |
| @@ -20,6 +22,10 @@ Optional properties for compatible string qcom,qca6174-bt: · 1 unmodified line | ||
| 20 | 22 | - clocks: clock provided to the controller (SUSCLK_32KHZ) |
| 21 | 23 | - firmware-name: specify the name of nvm firmware to load |
| 22 | 24 | |
| 25 | +Optional properties for compatible string qcom,qca9377-bt: | |
| 26 | + | |
| 27 | + - max-speed: see Documentation/devicetree/bindings/serial/serial.yaml | |
| 28 | + | |
| 23 | 29 | Required properties for compatible string qcom,wcn399x-bt: |
| 24 | 30 | |
| 25 | 31 | - vddio-supply: VDD_IO supply regulator handle. |
| @@ -0,0 +1,54 @@ | ||
| 1 | +# SPDX-License-Identifier: GPL-2.0 | |
| 2 | +%YAML 1.2 | |
| 3 | +--- | |
| 4 | +$id: http://devicetree.org/schemas/net/realtek-bluetooth.yaml# | |
| 5 | +$schema: http://devicetree.org/meta-schemas/core.yaml# | |
| 6 | + | |
| 7 | +title: RTL8723BS/RTL8723CS/RTL8822CS Bluetooth Device Tree Bindings | |
| 8 | + | |
| 9 | +maintainers: | |
| 10 | + - Vasily Khoruzhick <anarsoul@gmail.com> | |
| 11 | + - Alistair Francis <alistair@alistair23.me> | |
| 12 | + | |
| 13 | +description: | |
| 14 | + RTL8723CS/RTL8723CS/RTL8822CS is WiFi + BT chip. WiFi part is connected over | |
| 15 | + SDIO, while BT is connected over serial. It speaks H5 protocol with few | |
| 16 | + extra commands to upload firmware and change module speed. | |
| 17 | + | |
| 18 | +properties: | |
| 19 | + compatible: | |
| 20 | + oneOf: | |
| 21 | + - const: "realtek,rtl8723bs-bt" | |
| 22 | + - const: "realtek,rtl8723cs-bt" | |
| 23 | + - const: "realtek,rtl8822cs-bt" | |
| 24 | + | |
| 25 | + device-wake-gpios: | |
| 26 | + maxItems: 1 | |
| 27 | + description: GPIO specifier, used to wakeup the BT module | |
| 28 | + | |
| 29 | + enable-gpios: | |
| 30 | + maxItems: 1 | |
| 31 | + description: GPIO specifier, used to enable the BT module | |
| 32 | + | |
| 33 | + host-wake-gpios: | |
| 34 | + maxItems: 1 | |
| 35 | + description: GPIO specifier, used to wakeup the host processor | |
| 36 | + | |
| 37 | +required: | |
| 38 | + - compatible | |
| 39 | + | |
| 40 | +examples: | |
| 41 | + - | | |
| 42 | + #include <dt-bindings/gpio/gpio.h> | |
| 43 | + | |
| 44 | + uart1 { | |
| 45 | + pinctrl-names = "default"; | |
| 46 | + pinctrl-0 = <&uart1_pins>, <&uart1_rts_cts_pins>; | |
| 47 | + uart-has-rtscts = <1>; | |
| 48 | + | |
| 49 | + bluetooth { | |
| 50 | + compatible = "realtek,rtl8723bs-bt"; | |
| 51 | + device-wake-gpios = <&r_pio 0 5 GPIO_ACTIVE_HIGH>; /* PL5 */ | |
| 52 | + host-wakeup-gpios = <&r_pio 0 6 GPIO_ACTIVE_HIGH>; /* PL6 */ | |
| 53 | + }; | |
| 54 | + }; | |
| @@ -1,64 +0,0 @@ | ||
| 1 | −* Socionext AVE ethernet controller | |
| 2 | − | |
| 3 | −This describes the devicetree bindings for AVE ethernet controller | |
| 4 | −implemented on Socionext UniPhier SoCs. | |
| 5 | − | |
| 6 | −Required properties: | |
| 7 | − - compatible: Should be | |
| 8 | − - "socionext,uniphier-pro4-ave4" : for Pro4 SoC | |
| 9 | − - "socionext,uniphier-pxs2-ave4" : for PXs2 SoC | |
| 10 | − - "socionext,uniphier-ld11-ave4" : for LD11 SoC | |
| 11 | − - "socionext,uniphier-ld20-ave4" : for LD20 SoC | |
| 12 | − - "socionext,uniphier-pxs3-ave4" : for PXs3 SoC | |
| 13 | − - reg: Address where registers are mapped and size of region. | |
| 14 | − - interrupts: Should contain the MAC interrupt. | |
| 15 | − - phy-mode: See ethernet.txt in the same directory. Allow to choose | |
| 16 | − "rgmii", "rmii", "mii", or "internal" according to the PHY. | |
| 17 | − The acceptable mode is SoC-dependent. | |
| 18 | − - phy-handle: Should point to the external phy device. | |
| 19 | − See ethernet.txt file in the same directory. | |
| 20 | − - clocks: A phandle to the clock for the MAC. | |
| 21 | − For Pro4 SoC, that is "socionext,uniphier-pro4-ave4", | |
| 22 | − another MAC clock, GIO bus clock and PHY clock are also required. | |
| 23 | − - clock-names: Should contain | |
| 24 | − - "ether", "ether-gb", "gio", "ether-phy" for Pro4 SoC | |
| 25 | − - "ether" for others | |
| 26 | − - resets: A phandle to the reset control for the MAC. For Pro4 SoC, | |
| 27 | − GIO bus reset is also required. | |
| 28 | − - reset-names: Should contain | |
| 29 | − - "ether", "gio" for Pro4 SoC | |
| 30 | − - "ether" for others | |
| 31 | − - socionext,syscon-phy-mode: A phandle to syscon with one argument | |
| 32 | − that configures phy mode. The argument is the ID of MAC instance. | |
| 33 | − | |
| 34 | −The MAC address will be determined using the optional properties | |
| 35 | −defined in ethernet.txt. | |
| 36 | − | |
| 37 | −Required subnode: | |
| 38 | − - mdio: A container for child nodes representing phy nodes. | |
| 39 | − See phy.txt in the same directory. | |
| 40 | − | |
| 41 | −Example: | |
| 42 | − | |
| 43 | − ether: ethernet@65000000 { | |
| 44 | − compatible = "socionext,uniphier-ld20-ave4"; | |
| 45 | − reg = <0x65000000 0x8500>; | |
| 46 | − interrupts = <0 66 4>; | |
| 47 | − phy-mode = "rgmii"; | |
| 48 | − phy-handle = <ðphy>; | |
| 49 | − clock-names = "ether"; | |
| 50 | − clocks = <&sys_clk 6>; | |
| 51 | − reset-names = "ether"; | |
| 52 | − resets = <&sys_rst 6>; | |
| 53 | − socionext,syscon-phy-mode = <&soc_glue 0>; | |
| 54 | − local-mac-address = [00 00 00 00 00 00]; | |
| 55 | − | |
| 56 | − mdio { | |
| 57 | − #address-cells = <1>; | |
| 58 | − #size-cells = <0>; | |
| 59 | − | |
| 60 | − ethphy: ethphy@1 { | |
| 61 | − reg = <1>; | |
| 62 | − }; | |
| 63 | − }; | |
| 64 | − }; | |
| @@ -0,0 +1,111 @@ | ||
| 1 | +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) | |
| 2 | +%YAML 1.2 | |
| 3 | +--- | |
| 4 | +$id: http://devicetree.org/schemas/net/socionext,uniphier-ave4.yaml# | |
| 5 | +$schema: http://devicetree.org/meta-schemas/core.yaml# | |
| 6 | + | |
| 7 | +title: Socionext AVE ethernet controller | |
| 8 | + | |
| 9 | +maintainers: | |
| 10 | + - Kunihiko Hayashi <hayashi.kunihiko@socionext.com> | |
| 11 | + | |
| 12 | +description: | | |
| 13 | + This describes the devicetree bindings for AVE ethernet controller | |
| 14 | + implemented on Socionext UniPhier SoCs. | |
| 15 | + | |
| 16 | +allOf: | |
| 17 | + - $ref: ethernet-controller.yaml# | |
| 18 | + | |
| 19 | +properties: | |
| 20 | + compatible: | |
| 21 | + enum: | |
| 22 | + - socionext,uniphier-pro4-ave4 | |
| 23 | + - socionext,uniphier-pxs2-ave4 | |
| 24 | + - socionext,uniphier-ld11-ave4 | |
| 25 | + - socionext,uniphier-ld20-ave4 | |
| 26 | + - socionext,uniphier-pxs3-ave4 | |
| 27 | + | |
| 28 | + reg: | |
| 29 | + maxItems: 1 | |
| 30 | + | |
| 31 | + interrupts: | |
| 32 | + maxItems: 1 | |
| 33 | + | |
| 34 | + phy-mode: true | |
| 35 | + | |
| 36 | + phy-handle: true | |
| 37 | + | |
| 38 | + mac-address: true | |
| 39 | + | |
| 40 | + local-mac-address: true | |
| 41 | + | |
| 42 | + clocks: | |
| 43 | + minItems: 1 | |
| 44 | + maxItems: 4 | |
| 45 | + | |
| 46 | + clock-names: | |
| 47 | + oneOf: | |
| 48 | + - items: # for Pro4 | |
| 49 | + - const: gio | |
| 50 | + - const: ether | |
| 51 | + - const: ether-gb | |
| 52 | + - const: ether-phy | |
| 53 | + - const: ether # for others | |
| 54 | + | |
| 55 | + resets: | |
| 56 | + minItems: 1 | |
| 57 | + maxItems: 2 | |
| 58 | + | |
| 59 | + reset-names: | |
| 60 | + oneOf: | |
| 61 | + - items: # for Pro4 | |
| 62 | + - const: gio | |
| 63 | + - const: ether | |
| 64 | + - const: ether # for others | |
| 65 | + | |
| 66 | + socionext,syscon-phy-mode: | |
| 67 | + $ref: /schemas/types.yaml#definitions/phandle-array | |
| 68 | + description: | |
| 69 | + A phandle to syscon with one argument that configures phy mode. | |
| 70 | + The argument is the ID of MAC instance. | |
| 71 | + | |
| 72 | + mdio: | |
| 73 | + $ref: mdio.yaml# | |
| 74 | + | |
| 75 | +required: | |
| 76 | + - compatible | |
| 77 | + - reg | |
| 78 | + - interrupts | |
| 79 | + - phy-mode | |
| 80 | + - phy-handle | |
| 81 | + - clocks | |
| 82 | + - clock-names | |
| 83 | + - resets | |
| 84 | + - reset-names | |
| 85 | + - mdio | |
| 86 | + | |
| 87 | +additionalProperties: false | |
| 88 | + | |
| 89 | +examples: | |
| 90 | + - | | |
| 91 | + ether: ethernet@65000000 { | |
| 92 | + compatible = "socionext,uniphier-ld20-ave4"; | |
| 93 | + reg = <0x65000000 0x8500>; | |
| 94 | + interrupts = <0 66 4>; | |
| 95 | + phy-mode = "rgmii"; | |
| 96 | + phy-handle = <ðphy>; | |
| 97 | + clock-names = "ether"; | |
| 98 | + clocks = <&sys_clk 6>; | |
| 99 | + reset-names = "ether"; | |
| 100 | + resets = <&sys_rst 6>; | |
| 101 | + socionext,syscon-phy-mode = <&soc_glue 0>; | |
| 102 | + | |
| 103 | + mdio { | |
| 104 | + #address-cells = <1>; | |
| 105 | + #size-cells = <0>; | |
| 106 | + | |
| 107 | + ethphy: ethernet-phy@1 { | |
| 108 | + reg = <1>; | |
| 109 | + }; | |
| 110 | + }; | |
| 111 | + }; | |
| @@ -1,68 +0,0 @@ | ||
| 1 | −* Texas Instruments - dp83867 Giga bit ethernet phy | |
| 2 | − | |
| 3 | −Required properties: | |
| 4 | − - reg - The ID number for the phy, usually a small integer | |
| 5 | − - ti,rx-internal-delay - RGMII Receive Clock Delay - see dt-bindings/net/ti-dp83867.h | |
| 6 | − for applicable values. Required only if interface type is | |
| 7 | − PHY_INTERFACE_MODE_RGMII_ID or PHY_INTERFACE_MODE_RGMII_RXID | |
| 8 | − - ti,tx-internal-delay - RGMII Transmit Clock Delay - see dt-bindings/net/ti-dp83867.h | |
| 9 | − for applicable values. Required only if interface type is | |
| 10 | − PHY_INTERFACE_MODE_RGMII_ID or PHY_INTERFACE_MODE_RGMII_TXID | |
| 11 | − | |
| 12 | −Note: If the interface type is PHY_INTERFACE_MODE_RGMII the TX/RX clock delays | |
| 13 | − will be left at their default values, as set by the PHY's pin strapping. | |
| 14 | − The default strapping will use a delay of 2.00 ns. Thus | |
| 15 | − PHY_INTERFACE_MODE_RGMII, by default, does not behave as RGMII with no | |
| 16 | − internal delay, but as PHY_INTERFACE_MODE_RGMII_ID. The device tree | |
| 17 | − should use "rgmii-id" if internal delays are desired as this may be | |
| 18 | − changed in future to cause "rgmii" mode to disable delays. | |
| 19 | − | |
| 20 | −Optional property: | |
| 21 | − - ti,min-output-impedance - MAC Interface Impedance control to set | |
| 22 | − the programmable output impedance to | |
| 23 | − minimum value (35 ohms). | |
| 24 | − - ti,max-output-impedance - MAC Interface Impedance control to set | |
| 25 | − the programmable output impedance to | |
| 26 | − maximum value (70 ohms). | |
| 27 | − - ti,dp83867-rxctrl-strap-quirk - This denotes the fact that the | |
| 28 | − board has RX_DV/RX_CTRL pin strapped in | |
| 29 | − mode 1 or 2. To ensure PHY operation, | |
| 30 | − there are specific actions that | |
| 31 | − software needs to take when this pin is | |
| 32 | − strapped in these modes. See data manual | |
| 33 | − for details. | |
| 34 | − - ti,clk-output-sel - Muxing option for CLK_OUT pin. See dt-bindings/net/ti-dp83867.h | |
| 35 | − for applicable values. The CLK_OUT pin can also | |
| 36 | − be disabled by this property. When omitted, the | |
| 37 | − PHY's default will be left as is. | |
| 38 | − - ti,sgmii-ref-clock-output-enable - This denotes which | |
| 39 | − SGMII configuration is used (4 or 6-wire modes). | |
| 40 | − Some MACs work with differential SGMII clock. | |
| 41 | − See data manual for details. | |
| 42 | − | |
| 43 | − - ti,fifo-depth - Transmitt FIFO depth- see dt-bindings/net/ti-dp83867.h | |
| 44 | − for applicable values (deprecated) | |
| 45 | − | |
| 46 | − -tx-fifo-depth - As defined in the ethernet-controller.yaml. Values for | |
| 47 | − the depth can be found in dt-bindings/net/ti-dp83867.h | |
| 48 | − -rx-fifo-depth - As defined in the ethernet-controller.yaml. Values for | |
| 49 | − the depth can be found in dt-bindings/net/ti-dp83867.h | |
| 50 | − | |
| 51 | −Note: ti,min-output-impedance and ti,max-output-impedance are mutually | |
| 52 | − exclusive. When both properties are present ti,max-output-impedance | |
| 53 | − takes precedence. | |
| 54 | − | |
| 55 | −Default child nodes are standard Ethernet PHY device | |
| 56 | −nodes as described in Documentation/devicetree/bindings/net/phy.txt | |
| 57 | − | |
| 58 | −Example: | |
| 59 | − | |
| 60 | − ethernet-phy@0 { | |
| 61 | − reg = <0>; | |
| 62 | − ti,rx-internal-delay = <DP83867_RGMIIDCTL_2_25_NS>; | |
| 63 | − ti,tx-internal-delay = <DP83867_RGMIIDCTL_2_75_NS>; | |
| 64 | − tx-fifo-depth = <DP83867_PHYCR_FIFO_DEPTH_4_B_NIB>; | |
| 65 | − }; | |
| 66 | − | |
| 67 | −Datasheet can be found: | |
| 68 | −http://www.ti.com/product/DP83867IR/datasheet | |
| @@ -0,0 +1,127 @@ | ||
| 1 | +# SPDX-License-Identifier: (GPL-2.0+ OR BSD-2-Clause) | |
| 2 | +# Copyright (C) 2019 Texas Instruments Incorporated | |
| 3 | +%YAML 1.2 | |
| 4 | +--- | |
| 5 | +$id: "http://devicetree.org/schemas/net/ti,dp83867.yaml#" | |
| 6 | +$schema: "http://devicetree.org/meta-schemas/core.yaml#" | |
| 7 | + | |
| 8 | +title: TI DP83867 ethernet PHY | |
| 9 | + | |
| 10 | +allOf: | |
| 11 | + - $ref: "ethernet-controller.yaml#" | |
| 12 | + | |
| 13 | +maintainers: | |
| 14 | + - Dan Murphy <dmurphy@ti.com> | |
| 15 | + | |
| 16 | +description: | | |
| 17 | + The DP83867 device is a robust, low power, fully featured Physical Layer | |
| 18 | + transceiver with integrated PMD sublayers to support 10BASE-Te, 100BASE-TX | |
| 19 | + and 1000BASE-T Ethernet protocols. | |
| 20 | + | |
| 21 | + The DP83867 is designed for easy implementation of 10/100/1000 Mbps Ethernet | |
| 22 | + LANs. It interfaces directly to twisted pair media via an external | |
| 23 | + transformer. This device interfaces directly to the MAC layer through the | |
| 24 | + IEEE 802.3 Standard Media Independent Interface (MII), the IEEE 802.3 Gigabit | |
| 25 | + Media Independent Interface (GMII) or Reduced GMII (RGMII). | |
| 26 | + | |
| 27 | + Specifications about the charger can be found at: | |
| 28 | + https://www.ti.com/lit/gpn/dp83867ir | |
| 29 | + | |
| 30 | +properties: | |
| 31 | + reg: | |
| 32 | + maxItems: 1 | |
| 33 | + | |
| 34 | + ti,min-output-impedance: | |
| 35 | + type: boolean | |
| 36 | + description: | | |
| 37 | + MAC Interface Impedance control to set the programmable output impedance | |
| 38 | + to a minimum value (35 ohms). | |
| 39 | + | |
| 40 | + ti,max-output-impedance: | |
| 41 | + type: boolean | |
| 42 | + description: | | |
| 43 | + MAC Interface Impedance control to set the programmable output impedance | |
| 44 | + to a maximum value (70 ohms). | |
| 45 | + Note: ti,min-output-impedance and ti,max-output-impedance are mutually | |
| 46 | + exclusive. When both properties are present ti,max-output-impedance | |
| 47 | + takes precedence. | |
| 48 | + | |
| 49 | + tx-fifo-depth: | |
| 50 | + $ref: /schemas/types.yaml#definitions/uint32 | |
| 51 | + description: | | |
| 52 | + Transmitt FIFO depth see dt-bindings/net/ti-dp83867.h for values | |
| 53 | + | |
| 54 | + rx-fifo-depth: | |
| 55 | + $ref: /schemas/types.yaml#definitions/uint32 | |
| 56 | + description: | | |
| 57 | + Receive FIFO depth see dt-bindings/net/ti-dp83867.h for values | |
| 58 | + | |
| 59 | + ti,clk-output-sel: | |
| 60 | + $ref: /schemas/types.yaml#definitions/uint32 | |
| 61 | + description: | | |
| 62 | + Muxing option for CLK_OUT pin. See dt-bindings/net/ti-dp83867.h | |
| 63 | + for applicable values. The CLK_OUT pin can also be disabled by this | |
| 64 | + property. When omitted, the PHY's default will be left as is. | |
| 65 | + | |
| 66 | + ti,rx-internal-delay: | |
| 67 | + $ref: /schemas/types.yaml#definitions/uint32 | |
| 68 | + description: | | |
| 69 | + RGMII Receive Clock Delay - see dt-bindings/net/ti-dp83867.h | |
| 70 | + for applicable values. Required only if interface type is | |
| 71 | + PHY_INTERFACE_MODE_RGMII_ID or PHY_INTERFACE_MODE_RGMII_RXID. | |
| 72 | + | |
| 73 | + ti,tx-internal-delay: | |
| 74 | + $ref: /schemas/types.yaml#definitions/uint32 | |
| 75 | + description: | | |
| 76 | + RGMII Transmit Clock Delay - see dt-bindings/net/ti-dp83867.h | |
| 77 | + for applicable values. Required only if interface type is | |
| 78 | + PHY_INTERFACE_MODE_RGMII_ID or PHY_INTERFACE_MODE_RGMII_TXID. | |
| 79 | + | |
| 80 | + Note: If the interface type is PHY_INTERFACE_MODE_RGMII the TX/RX clock | |
| 81 | + delays will be left at their default values, as set by the PHY's pin | |
| 82 | + strapping. The default strapping will use a delay of 2.00 ns. Thus | |
| 83 | + PHY_INTERFACE_MODE_RGMII, by default, does not behave as RGMII with no | |
| 84 | + internal delay, but as PHY_INTERFACE_MODE_RGMII_ID. The device tree | |
| 85 | + should use "rgmii-id" if internal delays are desired as this may be | |
| 86 | + changed in future to cause "rgmii" mode to disable delays. | |
| 87 | + | |
| 88 | + ti,dp83867-rxctrl-strap-quirk: | |
| 89 | + type: boolean | |
| 90 | + description: | | |
| 91 | + This denotes the fact that the board has RX_DV/RX_CTRL pin strapped in | |
| 92 | + mode 1 or 2. To ensure PHY operation, there are specific actions that | |
| 93 | + software needs to take when this pin is strapped in these modes. | |
| 94 | + See data manual for details. | |
| 95 | + | |
| 96 | + ti,sgmii-ref-clock-output-enable: | |
| 97 | + type: boolean | |
| 98 | + description: | | |
| 99 | + This denotes which SGMII configuration is used (4 or 6-wire modes). | |
| 100 | + Some MACs work with differential SGMII clock. See data manual for details. | |
| 101 | + | |
| 102 | + ti,fifo-depth: | |
| 103 | + deprecated: true | |
| 104 | + $ref: /schemas/types.yaml#definitions/uint32 | |
| 105 | + description: | | |
| 106 | + Transmitt FIFO depth- see dt-bindings/net/ti-dp83867.h for applicable | |
| 107 | + values. | |
| 108 | + | |
| 109 | +required: | |
| 110 | + - reg | |
| 111 | + | |
| 112 | +examples: | |
| 113 | + - | | |
| 114 | + #include <dt-bindings/net/ti-dp83867.h> | |
| 115 | + mdio0 { | |
| 116 | + #address-cells = <1>; | |
| 117 | + #size-cells = <0>; | |
| 118 | + ethphy0: ethernet-phy@0 { | |
| 119 | + reg = <0>; | |
| 120 | + tx-fifo-depth = <DP83867_PHYCR_FIFO_DEPTH_4_B_NIB>; | |
| 121 | + rx-fifo-depth = <DP83867_PHYCR_FIFO_DEPTH_4_B_NIB>; | |
| 122 | + ti,max-output-impedance; | |
| 123 | + ti,clk-output-sel = <DP83867_CLK_O_SEL_CHN_A_RCLK>; | |
| 124 | + ti,rx-internal-delay = <DP83867_RGMIIDCTL_2_25_NS>; | |
| 125 | + ti,tx-internal-delay = <DP83867_RGMIIDCTL_2_75_NS>; | |
| 126 | + }; | |
| 127 | + }; | |
| @@ -1,4 +1,4 @@ | ||
| 1 | −# SPDX-License-Identifier: GPL-2.0 | |
| 1 | +# SPDX-License-Identifier: (GPL-2.0+ OR BSD-2-Clause) | |
| 2 | 2 | # Copyright (C) 2019 Texas Instruments Incorporated |
| 3 | 3 | %YAML 1.2 |
| 4 | 4 | --- |
| @@ -144,6 +144,13 @@ patternProperties: · 143 unmodified lines | ||
| 144 | 144 | description: |
| 145 | 145 | CPSW MDIO bus. |
| 146 | 146 | |
| 147 | + "^cpts@[0-9a-f]+": | |
| 148 | + type: object | |
| 149 | + allOf: | |
| 150 | + - $ref: "ti,k3-am654-cpts.yaml#" | |
| 151 | + description: | |
| 152 | + CPSW Common Platform Time Sync (CPTS) module. | |
| 153 | + | |
| 147 | 154 | required: |
| 148 | 155 | - compatible |
| 149 | 156 | - reg |
| @@ -164,6 +171,8 @@ examples: · 14 unmodified lines | ||
| 164 | 171 | #include <dt-bindings/pinctrl/k3.h> |
| 165 | 172 | #include <dt-bindings/soc/ti,sci_pm_domain.h> |
| 166 | 173 | #include <dt-bindings/net/ti-dp83867.h> |
| 174 | + #include <dt-bindings/interrupt-controller/irq.h> | |
| 175 | + #include <dt-bindings/interrupt-controller/arm-gic.h> | |
| 167 | 176 | |
| 168 | 177 | mcu_cpsw: ethernet@46000000 { |
| 169 | 178 | compatible = "ti,am654-cpsw-nuss"; |
| @@ -222,4 +231,15 @@ examples: · 52 unmodified lines | ||
| 222 | 231 | ti,fifo-depth = <DP83867_PHYCR_FIFO_DEPTH_4_B_NIB>; |
| 223 | 232 | }; |
| 224 | 233 | }; |
| 234 | + | |
| 235 | + cpts@3d000 { | |
| 236 | + compatible = "ti,am65-cpts"; | |
| 237 | + reg = <0x0 0x3d000 0x0 0x400>; | |
| 238 | + clocks = <&k3_clks 18 2>; | |
| 239 | + clock-names = "cpts"; | |
| 240 | + interrupts-extended = <&gic500 GIC_SPI 858 IRQ_TYPE_LEVEL_HIGH>; | |
| 241 | + interrupt-names = "cpts"; | |
| 242 | + ti,cpts-ext-ts-inputs = <4>; | |
| 243 | + ti,cpts-periodic-outputs = <2>; | |
| 244 | + }; | |
| 225 | 245 | }; |
| @@ -0,0 +1,145 @@ | ||
| 1 | +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) | |
| 2 | +%YAML 1.2 | |
| 3 | +--- | |
| 4 | +$id: http://devicetree.org/schemas/net/ti,k3-am654-cpts.yaml# | |
| 5 | +$schema: http://devicetree.org/meta-schemas/core.yaml# | |
| 6 | + | |
| 7 | +title: The TI AM654x/J721E Common Platform Time Sync (CPTS) module Device Tree Bindings | |
| 8 | + | |
| 9 | +maintainers: | |
| 10 | + - Grygorii Strashko <grygorii.strashko@ti.com> | |
| 11 | + - Sekhar Nori <nsekhar@ti.com> | |
| 12 | + | |
| 13 | +description: |+ | |
| 14 | + The TI AM654x/J721E CPTS module is used to facilitate host control of time | |
| 15 | + sync operations. | |
| 16 | + Main features of CPTS module are | |
| 17 | + - selection of multiple external clock sources | |
| 18 | + - Software control of time sync events via interrupt or polling | |
| 19 | + - 64-bit timestamp mode in ns with PPM and nudge adjustment. | |
| 20 | + - hardware timestamp push inputs (HWx_TS_PUSH) | |
| 21 | + - timestamp counter compare output (TS_COMP) | |
| 22 | + - timestamp counter bit output (TS_SYNC) | |
| 23 | + - periodic Generator function outputs (TS_GENFx) | |
| 24 | + - Ethernet Enhanced Scheduled Traffic Operations (CPTS_ESTFn) (TSN) | |
| 25 | + - external hardware timestamp push inputs (HWx_TS_PUSH) timestamping | |
| 26 | + | |
| 27 | + Depending on integration it enables compliance with the IEEE 1588-2008 | |
| 28 | + standard for a precision clock synchronization protocol, Ethernet Enhanced | |
| 29 | + Scheduled Traffic Operations (CPTS_ESTFn) and PCIe Subsystem Precision Time | |
| 30 | + Measurement (PTM). | |
| 31 | + | |
| 32 | + TI AM654x/J721E SoCs has several similar CPTS modules integrated into the | |
| 33 | + different parts of the system which could be synchronized with each other | |
| 34 | + - Main CPTS | |
| 35 | + - MCU CPSW CPTS with IEEE 1588-2008 support | |
| 36 | + - PCIe subsystem CPTS for PTM support | |
| 37 | + | |
| 38 | + Depending on CPTS module integration and when CPTS is integral part of | |
| 39 | + another module (MCU CPSW for example) "compatible" and "reg" can | |
| 40 | + be omitted - parent module is fully responsible for CPTS enabling and | |
| 41 | + configuration. | |
| 42 | + | |
| 43 | +properties: | |
| 44 | + $nodename: | |
| 45 | + pattern: "^cpts@[0-9a-f]+$" | |
| 46 | + | |
| 47 | + compatible: | |
| 48 | + oneOf: | |
| 49 | + - const: ti,am65-cpts | |
| 50 | + - const: ti,j721e-cpts | |
| 51 | + | |
| 52 | + reg: | |
| 53 | + maxItems: 1 | |
| 54 | + description: | |
| 55 | + The physical base address and size of CPTS IO range | |
| 56 | + | |
| 57 | + reg-names: | |
| 58 | + items: | |
| 59 | + - const: cpts | |
| 60 | + | |
| 61 | + clocks: | |
| 62 | + description: CPTS reference clock | |
| 63 | + | |
| 64 | + clock-names: | |
| 65 | + items: | |
| 66 | + - const: cpts | |
| 67 | + | |
| 68 | + interrupts: | |
| 69 | + items: | |
| 70 | + - description: CPTS events interrupt | |
| 71 | + | |
| 72 | + interrupt-names: | |
| 73 | + items: | |
| 74 | + - const: cpts | |
| 75 | + | |
| 76 | + ti,cpts-ext-ts-inputs: | |
| 77 | + allOf: | |
| 78 | + - $ref: /schemas/types.yaml#/definitions/uint32 | |
| 79 | + maximum: 8 | |
| 80 | + description: | |
| 81 | + Number of hardware timestamp push inputs (HWx_TS_PUSH) | |
| 82 | + | |
| 83 | + ti,cpts-periodic-outputs: | |
| 84 | + allOf: | |
| 85 | + - $ref: /schemas/types.yaml#/definitions/uint32 | |
| 86 | + maximum: 8 | |
| 87 | + description: | |
| 88 | + Number of timestamp Generator function outputs (TS_GENFx) | |
| 89 | + | |
| 90 | + refclk-mux: | |
| 91 | + type: object | |
| 92 | + description: CPTS reference clock multiplexer clock | |
| 93 | + properties: | |
| 94 | + '#clock-cells': | |
| 95 | + const: 0 | |
| 96 | + | |
| 97 | + clocks: | |
| 98 | + maxItems: 8 | |
| 99 | + | |
| 100 | + assigned-clocks: | |
| 101 | + maxItems: 1 | |
| 102 | + | |
| 103 | + assigned-clocks-parents: | |
| 104 | + maxItems: 1 | |
| 105 | + | |
| 106 | + required: | |
| 107 | + - clocks | |
| 108 | + | |
| 109 | +required: | |
| 110 | + - compatible | |
| 111 | + - reg | |
| 112 | + - clocks | |
| 113 | + - clock-names | |
| 114 | + - interrupts | |
| 115 | + - interrupt-names | |
| 116 | + | |
| 117 | +additionalProperties: false | |
| 118 | + | |
| 119 | +examples: | |
| 120 | + - | | |
| 121 | + #include <dt-bindings/interrupt-controller/irq.h> | |
| 122 | + #include <dt-bindings/interrupt-controller/arm-gic.h> | |
| 123 | + | |
| 124 | + cpts@310d0000 { | |
| 125 | + compatible = "ti,am65-cpts"; | |
| 126 | + reg = <0x0 0x310d0000 0x0 0x400>; | |
| 127 | + reg-names = "cpts"; | |
| 128 | + clocks = <&main_cpts_mux>; | |
| 129 | + clock-names = "cpts"; | |
| 130 | + interrupts-extended = <&k3_irq 163 0 IRQ_TYPE_LEVEL_HIGH>; | |
| 131 | + interrupt-names = "cpts"; | |
| 132 | + ti,cpts-periodic-outputs = <6>; | |
| 133 | + ti,cpts-ext-ts-inputs = <8>; | |
| 134 | + | |
| 135 | + main_cpts_mux: refclk-mux { | |
| 136 | + #clock-cells = <0>; | |
| 137 | + clocks = <&k3_clks 118 5>, <&k3_clks 118 11>, | |
| 138 | + <&k3_clks 157 91>, <&k3_clks 157 77>, | |
| 139 | + <&k3_clks 157 102>, <&k3_clks 157 80>, | |
| 140 | + <&k3_clks 120 3>, <&k3_clks 121 3>; | |
| 141 | + assigned-clocks = <&main_cpts_mux>; | |
| 142 | + assigned-clock-parents = <&k3_clks 118 11>; | |
| 143 | + }; | |
| 144 | + }; | |
| 145 | + | |
| @@ -25,6 +25,9 @@ Optional properties: · 24 unmodified lines | ||
| 25 | 25 | - mediatek,mtd-eeprom: Specify a MTD partition + offset containing EEPROM data |
| 26 | 26 | - big-endian: if the radio eeprom partition is written in big-endian, specify |
| 27 | 27 | this property |
| 28 | +- mediatek,eeprom-merge-otp: Merge EEPROM data with OTP data. Can be used on | |
| 29 | + boards where the flash calibration data is generic and specific calibration | |
| 30 | + data should be pulled from the OTP ROM | |
| 28 | 31 | |
| 29 | 32 | The MAC address can as well be set with corresponding optional properties |
| 30 | 33 | defined in net/ethernet.txt. |
| @@ -96,6 +96,17 @@ Optional properties: · 95 unmodified lines | ||
| 96 | 96 | - qcom,coexist-gpio-pin : gpio pin number information to support coex |
| 97 | 97 | which will be used by wifi firmware. |
| 98 | 98 | |
| 99 | +* Subnodes | |
| 100 | +The ath10k wifi node can contain one optional firmware subnode. | |
| 101 | +Firmware subnode is needed when the platform does not have TustZone. | |
| 102 | +The firmware subnode must have: | |
| 103 | + | |
| 104 | +- iommus: | |
| 105 | + Usage: required | |
| 106 | + Value type: <prop-encoded-array> | |
| 107 | + Definition: A list of phandle and IOMMU specifier pairs. | |
| 108 | + | |
| 109 | + | |
| 99 | 110 | Example (to supply PCI based wifi block details): |
| 100 | 111 | |
| 101 | 112 | In this example, the node is defined as child node of the PCI controller. |
| @@ -196,4 +207,7 @@ wifi@18000000 { · 94 unmodified lines | ||
| 196 | 207 | memory-region = <&wifi_msa_mem>; |
| 197 | 208 | iommus = <&apps_smmu 0x0040 0x1>; |
| 198 | 209 | qcom,msa-fixed-perm; |
| 210 | + wifi-firmware { | |
| 211 | + iommus = <&apps_iommu 0xc22 0x1>; | |
| 212 | + }; | |
| 199 | 213 | }; |
| @@ -372,6 +372,11 @@ MUX · 371 unmodified lines | ||
| 372 | 372 | devm_mux_chip_register() |
| 373 | 373 | devm_mux_control_get() |
| 374 | 374 | |
| 375 | +NET | |
| 376 | + devm_alloc_etherdev() | |
| 377 | + devm_alloc_etherdev_mqs() | |
| 378 | + devm_register_netdev() | |
| 379 | + | |
| 375 | 380 | PER-CPU MEM |
| 376 | 381 | devm_alloc_percpu() |
| 377 | 382 | devm_free_percpu() |
| @@ -70,7 +70,7 @@ list of volume location server IP addresses:: · 69 unmodified lines | ||
| 70 | 70 | The first module is the AF_RXRPC network protocol driver. This provides the |
| 71 | 71 | RxRPC remote operation protocol and may also be accessed from userspace. See: |
| 72 | 72 | |
| 73 | − Documentation/networking/rxrpc.txt | |
| 73 | + Documentation/networking/rxrpc.rst | |
| 74 | 74 | |
| 75 | 75 | The second module is the kerberos RxRPC security driver, and the third module |
| 76 | 76 | is the actual filesystem driver for the AFS filesystem. |
| @@ -0,0 +1,45 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0-only | |
| 2 | + | |
| 3 | +Broadcom BCM54140 Quad SGMII/QSGMII PHY | |
| 4 | +======================================= | |
| 5 | + | |
| 6 | +Supported chips: | |
| 7 | + | |
| 8 | + * Broadcom BCM54140 | |
| 9 | + | |
| 10 | + Datasheet: not public | |
| 11 | + | |
| 12 | +Author: Michael Walle <michael@walle.cc> | |
| 13 | + | |
| 14 | +Description | |
| 15 | +----------- | |
| 16 | + | |
| 17 | +The Broadcom BCM54140 is a Quad SGMII/QSGMII PHY which supports monitoring | |
| 18 | +its die temperature as well as two analog voltages. | |
| 19 | + | |
| 20 | +The AVDDL is a 1.0V analogue voltage, the AVDDH is a 3.3V analogue voltage. | |
| 21 | +Both voltages and the temperature are measured in a round-robin fashion. | |
| 22 | + | |
| 23 | +Sysfs entries | |
| 24 | +------------- | |
| 25 | + | |
| 26 | +The following attributes are supported. | |
| 27 | + | |
| 28 | +======================= ======================================================== | |
| 29 | +in0_label "AVDDL" | |
| 30 | +in0_input Measured AVDDL voltage. | |
| 31 | +in0_min Minimum AVDDL voltage. | |
| 32 | +in0_max Maximum AVDDL voltage. | |
| 33 | +in0_alarm AVDDL voltage alarm. | |
| 34 | + | |
| 35 | +in1_label "AVDDH" | |
| 36 | +in1_input Measured AVDDH voltage. | |
| 37 | +in1_min Minimum AVDDH voltage. | |
| 38 | +in1_max Maximum AVDDH voltage. | |
| 39 | +in1_alarm AVDDH voltage alarm. | |
| 40 | + | |
| 41 | +temp1_input Die temperature. | |
| 42 | +temp1_min Minimum die temperature. | |
| 43 | +temp1_max Maximum die temperature. | |
| 44 | +temp1_alarm Die temperature alarm. | |
| 45 | +======================= ======================================================== | |
| @@ -43,6 +43,7 @@ Hardware Monitoring Kernel Drivers · 42 unmodified lines | ||
| 43 | 43 | asb100 |
| 44 | 44 | asc7621 |
| 45 | 45 | aspeed-pwm-tacho |
| 46 | + bcm54140 | |
| 46 | 47 | bel-pfe |
| 47 | 48 | bt1-pvt |
| 48 | 49 | coretemp |
| @@ -1,27 +1,36 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +============== | |
| 4 | +6pack Protocol | |
| 5 | +============== | |
| 6 | + | |
| 1 | 7 | This is the 6pack-mini-HOWTO, written by |
| 2 | 8 | |
| 3 | 9 | Andreas Könsgen DG3KQ |
| 4 | −Internet: ajk@comnets.uni-bremen.de | |
| 5 | −AMPR-net: dg3kq@db0pra.ampr.org | |
| 6 | −AX.25: dg3kq@db0ach.#nrw.deu.eu | |
| 10 | + | |
| 11 | +:Internet: ajk@comnets.uni-bremen.de | |
| 12 | +:AMPR-net: dg3kq@db0pra.ampr.org | |
| 13 | +:AX.25: dg3kq@db0ach.#nrw.deu.eu | |
| 7 | 14 | |
| 8 | 15 | Last update: April 7, 1998 |
| 9 | 16 | |
| 10 | 17 | 1. What is 6pack, and what are the advantages to KISS? |
| 18 | +====================================================== | |
| 11 | 19 | |
| 12 | 20 | 6pack is a transmission protocol for data exchange between the PC and |
| 13 | 21 | the TNC over a serial line. It can be used as an alternative to KISS. |
| 14 | 22 | |
| 15 | 23 | 6pack has two major advantages: |
| 24 | + | |
| 16 | 25 | - The PC is given full control over the radio |
| 17 | 26 | channel. Special control data is exchanged between the PC and the TNC so |
| 18 | 27 | that the PC knows at any time if the TNC is receiving data, if a TNC |
| 19 | 28 | buffer underrun or overrun has occurred, if the PTT is |
| 20 | 29 | set and so on. This control data is processed at a higher priority than |
| 21 | 30 | normal data, so a data stream can be interrupted at any time to issue an |
| 22 | − important event. This helps to improve the channel access and timing | |
| 23 | − algorithms as everything is computed in the PC. It would even be possible | |
| 24 | − to experiment with something completely different from the known CSMA and | |
| 31 | + important event. This helps to improve the channel access and timing | |
| 32 | + algorithms as everything is computed in the PC. It would even be possible | |
| 33 | + to experiment with something completely different from the known CSMA and | |
| 25 | 34 | DAMA channel access methods. |
| 26 | 35 | This kind of real-time control is especially important to supply several |
| 27 | 36 | TNCs that are connected between each other and the PC by a daisy chain |
| @@ -36,6 +45,7 @@ More details about 6pack are described in the file 6pack.ps that is located · 8 unmodified lines | ||
| 36 | 45 | in the doc directory of the AX.25 utilities package. |
| 37 | 46 | |
| 38 | 47 | 2. Who has developed the 6pack protocol? |
| 48 | +======================================== | |
| 39 | 49 | |
| 40 | 50 | The 6pack protocol has been developed by Ekki Plicht DF4OR, Henning Rech |
| 41 | 51 | DF9IC and Gunter Jost DK7WJ. A driver for 6pack, written by Gunter Jost and |
| @@ -44,12 +54,14 @@ They have also written a firmware for TNCs to perform the 6pack · 2 unmodified lines | ||
| 44 | 54 | protocol (see section 4 below). |
| 45 | 55 | |
| 46 | 56 | 3. Where can I get the latest version of 6pack for LinuX? |
| 57 | +========================================================= | |
| 47 | 58 | |
| 48 | 59 | At the moment, the 6pack stuff can obtained via anonymous ftp from |
| 49 | 60 | db0bm.automation.fh-aachen.de. In the directory /incoming/dg3kq, |
| 50 | 61 | there is a file named 6pack.tgz. |
| 51 | 62 | |
| 52 | 63 | 4. Preparing the TNC for 6pack operation |
| 64 | +======================================== | |
| 53 | 65 | |
| 54 | 66 | To be able to use 6pack, a special firmware for the TNC is needed. The EPROM |
| 55 | 67 | of a newly bought TNC does not contain 6pack, so you will have to |
| @@ -75,12 +87,14 @@ and the status LED are lit for about a second if the firmware initialises · 19 unmodified lines | ||
| 75 | 87 | the TNC correctly. |
| 76 | 88 | |
| 77 | 89 | 5. Building and installing the 6pack driver |
| 90 | +=========================================== | |
| 78 | 91 | |
| 79 | 92 | The driver has been tested with kernel version 2.1.90. Use with older |
| 80 | 93 | kernels may lead to a compilation error because the interface to a kernel |
| 81 | 94 | function has been changed in the 2.1.8x kernels. |
| 82 | 95 | |
| 83 | 96 | How to turn on 6pack support: |
| 97 | +============================= | |
| 84 | 98 | |
| 85 | 99 | - In the linux kernel configuration program, select the code maturity level |
| 86 | 100 | options menu and turn on the prompting for development drivers. |
| @@ -94,27 +108,28 @@ To use the driver, the kissattach program delivered with the AX.25 utilities · 7 unmodified lines | ||
| 94 | 108 | has to be modified. |
| 95 | 109 | |
| 96 | 110 | - Do a cd to the directory that holds the kissattach sources. Edit the |
| 97 | − kissattach.c file. At the top, insert the following lines: | |
| 111 | + kissattach.c file. At the top, insert the following lines:: | |
| 112 | + | |
| 113 | + #ifndef N_6PACK | |
| 114 | + #define N_6PACK (N_AX25+1) | |
| 115 | + #endif | |
| 98 | 116 | |
| 99 | − #ifndef N_6PACK | |
| 100 | − #define N_6PACK (N_AX25+1) | |
| 101 | − #endif | |
| 117 | + Then find the line: | |
| 102 | 118 | |
| 103 | − Then find the line | |
| 104 | − | |
| 105 | − int disc = N_AX25; | |
| 119 | + int disc = N_AX25; | |
| 106 | 120 | |
| 107 | 121 | and replace N_AX25 by N_6PACK. |
| 108 | 122 | |
| 109 | 123 | - Recompile kissattach. Rename it to spattach to avoid confusions. |
| 110 | 124 | |
| 111 | 125 | Installing the driver: |
| 126 | +---------------------- | |
| 112 | 127 | |
| 113 | −- Do an insmod 6pack. Look at your /var/log/messages file to check if the | |
| 128 | +- Do an insmod 6pack. Look at your /var/log/messages file to check if the | |
| 114 | 129 | module has printed its initialization message. |
| 115 | 130 | |
| 116 | 131 | - Do a spattach as you would launch kissattach when starting a KISS port. |
| 117 | − Check if the kernel prints the message '6pack: TNC found'. | |
| 132 | + Check if the kernel prints the message '6pack: TNC found'. | |
| 118 | 133 | |
| 119 | 134 | - From here, everything should work as if you were setting up a KISS port. |
| 120 | 135 | The only difference is that the network device that represents |
| @@ -138,6 +153,7 @@ from the PC to the TNC over the serial line, the status LED if data is · 17 unmodified lines | ||
| 138 | 153 | sent to the PC. |
| 139 | 154 | |
| 140 | 155 | 6. Known problems |
| 156 | +================= | |
| 141 | 157 | |
| 142 | 158 | When testing the driver with 2.0.3x kernels and |
| 143 | 159 | operating with data rates on the radio channel of 9600 Baud or higher, |
| @@ -1,6 +1,12 @@ | ||
| 1 | − Altera Triple-Speed Ethernet MAC driver | |
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | 2 | |
| 3 | −Copyright (C) 2008-2014 Altera Corporation | |
| 3 | +.. include:: <isonum.txt> | |
| 4 | + | |
| 5 | +======================================= | |
| 6 | +Altera Triple-Speed Ethernet MAC driver | |
| 7 | +======================================= | |
| 8 | + | |
| 9 | +Copyright |copy| 2008-2014 Altera Corporation | |
| 4 | 10 | |
| 5 | 11 | This is the driver for the Altera Triple-Speed Ethernet (TSE) controllers |
| 6 | 12 | using the SGDMA and MSGDMA soft DMA IP components. The driver uses the |
| @@ -46,23 +52,33 @@ Jumbo frames are not supported at this time. · 39 unmodified lines | ||
| 46 | 52 | The driver limits PHY operations to 10/100Mbps, and has not yet been fully |
| 47 | 53 | tested for 1Gbps. This support will be added in a future maintenance update. |
| 48 | 54 | |
| 49 | −1) Kernel Configuration | |
| 55 | +1. Kernel Configuration | |
| 56 | +======================= | |
| 57 | + | |
| 50 | 58 | The kernel configuration option is ALTERA_TSE: |
| 59 | + | |
| 51 | 60 | Device Drivers ---> Network device support ---> Ethernet driver support ---> |
| 52 | 61 | Altera Triple-Speed Ethernet MAC support (ALTERA_TSE) |
| 53 | 62 | |
| 54 | −2) Driver parameters list: | |
| 55 | − debug: message level (0: no output, 16: all); | |
| 56 | − dma_rx_num: Number of descriptors in the RX list (default is 64); | |
| 57 | − dma_tx_num: Number of descriptors in the TX list (default is 64). | |
| 63 | +2. Driver parameters list | |
| 64 | +========================= | |
| 65 | + | |
| 66 | + - debug: message level (0: no output, 16: all); | |
| 67 | + - dma_rx_num: Number of descriptors in the RX list (default is 64); | |
| 68 | + - dma_tx_num: Number of descriptors in the TX list (default is 64). | |
| 69 | + | |
| 70 | +3. Command line options | |
| 71 | +======================= | |
| 72 | + | |
| 73 | +Driver parameters can be also passed in command line by using:: | |
| 58 | 74 | |
| 59 | −3) Command line options | |
| 60 | −Driver parameters can be also passed in command line by using: | |
| 61 | 75 | altera_tse=dma_rx_num:128,dma_tx_num:512 |
| 62 | 76 | |
| 63 | −4) Driver information and notes | |
| 77 | +4. Driver information and notes | |
| 78 | +=============================== | |
| 64 | 79 | |
| 65 | −4.1) Transmit process | |
| 80 | +4.1. Transmit process | |
| 81 | +--------------------- | |
| 66 | 82 | When the driver's transmit routine is called by the kernel, it sets up a |
| 67 | 83 | transmit descriptor by calling the underlying DMA transmit routine (SGDMA or |
| 68 | 84 | MSGDMA), and initiates a transmit operation. Once the transmit is complete, an |
| @@ -70,7 +86,8 @@ interrupt is driven by the transmit DMA logic. The driver handles the transmit · 1 unmodified line | ||
| 70 | 86 | completion in the context of the interrupt handling chain by recycling |
| 71 | 87 | resource required to send and track the requested transmit operation. |
| 72 | 88 | |
| 73 | −4.2) Receive process | |
| 89 | +4.2. Receive process | |
| 90 | +-------------------- | |
| 74 | 91 | The driver will post receive buffers to the receive DMA logic during driver |
| 75 | 92 | initialization. Receive buffers may or may not be queued depending upon the |
| 76 | 93 | underlying DMA logic (MSGDMA is able queue receive buffers, SGDMA is not able |
| @@ -79,34 +96,39 @@ received, the DMA logic generates an interrupt. The driver handles a receive · 2 unmodified lines | ||
| 79 | 96 | interrupt by obtaining the DMA receive logic status, reaping receive |
| 80 | 97 | completions until no more receive completions are available. |
| 81 | 98 | |
| 82 | −4.3) Interrupt Mitigation | |
| 99 | +4.3. Interrupt Mitigation | |
| 100 | +------------------------- | |
| 83 | 101 | The driver is able to mitigate the number of its DMA interrupts |
| 84 | 102 | using NAPI for receive operations. Interrupt mitigation is not yet supported |
| 85 | 103 | for transmit operations, but will be added in a future maintenance release. |
| 86 | 104 | |
| 87 | 105 | 4.4) Ethtool support |
| 106 | +-------------------- | |
| 88 | 107 | Ethtool is supported. Driver statistics and internal errors can be taken using: |
| 89 | 108 | ethtool -S ethX command. It is possible to dump registers etc. |
| 90 | 109 | |
| 91 | 110 | 4.5) PHY Support |
| 111 | +---------------- | |
| 92 | 112 | The driver is compatible with PAL to work with PHY and GPHY devices. |
| 93 | 113 | |
| 94 | 114 | 4.7) List of source files: |
| 95 | − o Kconfig | |
| 96 | − o Makefile | |
| 97 | − o altera_tse_main.c: main network device driver | |
| 98 | − o altera_tse_ethtool.c: ethtool support | |
| 99 | − o altera_tse.h: private driver structure and common definitions | |
| 100 | − o altera_msgdma.h: MSGDMA implementation function definitions | |
| 101 | − o altera_sgdma.h: SGDMA implementation function definitions | |
| 102 | − o altera_msgdma.c: MSGDMA implementation | |
| 103 | − o altera_sgdma.c: SGDMA implementation | |
| 104 | − o altera_sgdmahw.h: SGDMA register and descriptor definitions | |
| 105 | − o altera_msgdmahw.h: MSGDMA register and descriptor definitions | |
| 106 | − o altera_utils.c: Driver utility functions | |
| 107 | − o altera_utils.h: Driver utility function definitions | |
| 108 | − | |
| 109 | −5) Debug Information | |
| 115 | +-------------------------- | |
| 116 | + - Kconfig | |
| 117 | + - Makefile | |
| 118 | + - altera_tse_main.c: main network device driver | |
| 119 | + - altera_tse_ethtool.c: ethtool support | |
| 120 | + - altera_tse.h: private driver structure and common definitions | |
| 121 | + - altera_msgdma.h: MSGDMA implementation function definitions | |
| 122 | + - altera_sgdma.h: SGDMA implementation function definitions | |
| 123 | + - altera_msgdma.c: MSGDMA implementation | |
| 124 | + - altera_sgdma.c: SGDMA implementation | |
| 125 | + - altera_sgdmahw.h: SGDMA register and descriptor definitions | |
| 126 | + - altera_msgdmahw.h: MSGDMA register and descriptor definitions | |
| 127 | + - altera_utils.c: Driver utility functions | |
| 128 | + - altera_utils.h: Driver utility function definitions | |
| 129 | + | |
| 130 | +5. Debug Information | |
| 131 | +==================== | |
| 110 | 132 | |
| 111 | 133 | The driver exports debug information such as internal statistics, |
| 112 | 134 | debug information, MAC and DMA registers etc. |
| @@ -118,17 +140,18 @@ or sees the MAC registers: e.g. using: ethtool -d ethX · 5 unmodified lines | ||
| 118 | 140 | The developer can also use the "debug" module parameter to get |
| 119 | 141 | further debug information. |
| 120 | 142 | |
| 121 | −6) Statistics Support | |
| 143 | +6. Statistics Support | |
| 144 | +===================== | |
| 122 | 145 | |
| 123 | 146 | The controller and driver support a mix of IEEE standard defined statistics, |
| 124 | 147 | RFC defined statistics, and driver or Altera defined statistics. The four |
| 125 | 148 | specifications containing the standard definitions for these statistics are |
| 126 | 149 | as follows: |
| 127 | 150 | |
| 128 | − o IEEE 802.3-2012 - IEEE Standard for Ethernet. | |
| 129 | − o RFC 2863 found at http://www.rfc-editor.org/rfc/rfc2863.txt. | |
| 130 | − o RFC 2819 found at http://www.rfc-editor.org/rfc/rfc2819.txt. | |
| 131 | − o Altera Triple Speed Ethernet User Guide, found at http://www.altera.com | |
| 151 | + - IEEE 802.3-2012 - IEEE Standard for Ethernet. | |
| 152 | + - RFC 2863 found at http://www.rfc-editor.org/rfc/rfc2863.txt. | |
| 153 | + - RFC 2819 found at http://www.rfc-editor.org/rfc/rfc2819.txt. | |
| 154 | + - Altera Triple Speed Ethernet User Guide, found at http://www.altera.com | |
| 132 | 155 | |
| 133 | 156 | The statistics supported by the TSE and the device driver are as follows: |
| 134 | 157 | |
| @@ -1,11 +1,15 @@ | ||
| 1 | − | |
| 2 | −----------------------------------------------------------------------------- | |
| 3 | −1) This file is a supplement to arcnet.txt. Please read that for general | |
| 4 | − driver configuration help. | |
| 5 | −----------------------------------------------------------------------------- | |
| 6 | −2) This file is no longer Linux-specific. It should probably be moved out of | |
| 7 | − the kernel sources. Ideas? | |
| 8 | −----------------------------------------------------------------------------- | |
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +=============== | |
| 4 | +ARCnet Hardware | |
| 5 | +=============== | |
| 6 | + | |
| 7 | +.. note:: | |
| 8 | + | |
| 9 | + 1) This file is a supplement to arcnet.txt. Please read that for general | |
| 10 | + driver configuration help. | |
| 11 | + 2) This file is no longer Linux-specific. It should probably be moved out | |
| 12 | + of the kernel sources. Ideas? | |
| 9 | 13 | |
| 10 | 14 | Because so many people (myself included) seem to have obtained ARCnet cards |
| 11 | 15 | without manuals, this file contains a quick introduction to ARCnet hardware, |
| @@ -14,8 +18,8 @@ e-mail apenwarr@worldvisions.ca with any settings for your particular card, · 2 unmodified lines | ||
| 14 | 18 | or any other information you have! |
| 15 | 19 | |
| 16 | 20 | |
| 17 | −INTRODUCTION TO ARCNET | |
| 18 | −---------------------- | |
| 21 | +Introduction to ARCnet | |
| 22 | +====================== | |
| 19 | 23 | |
| 20 | 24 | ARCnet is a network type which works in a way similar to popular Ethernet |
| 21 | 25 | networks but which is also different in some very important ways. |
| @@ -30,7 +34,7 @@ since I only have the 2.5 Mbps variety. It is probably not going to saturate · 8 unmodified lines | ||
| 30 | 34 | your 100 Mbps card. Stop complaining. :) |
| 31 | 35 | |
| 32 | 36 | You also cannot connect an ARCnet card to any kind of Ethernet card and |
| 33 | −expect it to work. | |
| 37 | +expect it to work. | |
| 34 | 38 | |
| 35 | 39 | There are two "types" of ARCnet - STAR topology and BUS topology. This |
| 36 | 40 | refers to how the cards are meant to be wired together. According to most |
| @@ -71,19 +75,24 @@ although they are generally kept down to the Ethernet-style 1500 bytes. · 34 unmodified lines | ||
| 71 | 75 | For more information on the advantages and disadvantages (mostly the |
| 72 | 76 | advantages) of ARCnet networks, you might try the "ARCnet Trade Association" |
| 73 | 77 | WWW page: |
| 78 | + | |
| 74 | 79 | http://www.arcnet.com |
| 75 | 80 | |
| 76 | 81 | |
| 77 | −CABLING ARCNET NETWORKS | |
| 78 | −----------------------- | |
| 82 | +Cabling ARCnet Networks | |
| 83 | +======================= | |
| 84 | + | |
| 85 | +This section was rewritten by | |
| 86 | + | |
| 87 | + Vojtech Pavlik <vojtech@suse.cz> | |
| 79 | 88 | |
| 80 | −This section was rewritten by | |
| 81 | − Vojtech Pavlik <vojtech@suse.cz> | |
| 82 | 89 | using information from several people, including: |
| 83 | − Avery Pennraun <apenwarr@worldvisions.ca> | |
| 84 | − Stephen A. Wood <saw@hallc1.cebaf.gov> | |
| 85 | − John Paul Morrison <jmorriso@bogomips.ee.ubc.ca> | |
| 86 | − Joachim Koenig <jojo@repas.de> | |
| 90 | + | |
| 91 | + - Avery Pennraun <apenwarr@worldvisions.ca> | |
| 92 | + - Stephen A. Wood <saw@hallc1.cebaf.gov> | |
| 93 | + - John Paul Morrison <jmorriso@bogomips.ee.ubc.ca> | |
| 94 | + - Joachim Koenig <jojo@repas.de> | |
| 95 | + | |
| 87 | 96 | and Avery touched it up a bit, at Vojtech's request. |
| 88 | 97 | |
| 89 | 98 | ARCnet (the classic 2.5 Mbps version) can be connected by two different |
| @@ -103,13 +112,13 @@ equal to a high impedance one with a terminator installed. · 13 unmodified lines | ||
| 103 | 112 | |
| 104 | 113 | Usually, the ARCnet networks are built up from STAR cards and hubs. There |
| 105 | 114 | are two types of hubs - active and passive. Passive hubs are small boxes |
| 106 | −with four BNC connectors containing four 47 Ohm resistors: | |
| 115 | +with four BNC connectors containing four 47 Ohm resistors:: | |
| 107 | 116 | |
| 108 | − | | wires | |
| 109 | − R + junction | |
| 110 | −-R-+-R- R 47 Ohm resistors | |
| 111 | − R | |
| 112 | − | | |
| 117 | + | | wires | |
| 118 | + R + junction | |
| 119 | + -R-+-R- R 47 Ohm resistors | |
| 120 | + R | |
| 121 | + | | |
| 113 | 122 | |
| 114 | 123 | The shielding is connected together. Active hubs are much more complicated; |
| 115 | 124 | they are powered and contain electronics to amplify the signal and send it |
| @@ -127,14 +136,15 @@ And now to the cabling. What you can connect together: · 11 unmodified lines | ||
| 127 | 136 | 2. A card to a passive hub. Remember that all unused connectors on the hub |
| 128 | 137 | must be properly terminated with 93 Ohm (or something else if you don't |
| 129 | 138 | have the right ones) terminators. |
| 130 | − (Avery's note: oops, I didn't know that. Mine (TV cable) works | |
| 139 | + | |
| 140 | + (Avery's note: oops, I didn't know that. Mine (TV cable) works | |
| 131 | 141 | anyway, though.) |
| 132 | 142 | |
| 133 | 143 | 3. A card to an active hub. Here is no need to terminate the unused |
| 134 | 144 | connectors except some kind of aesthetic feeling. But, there may not be |
| 135 | 145 | more than eleven active hubs between any two computers. That of course |
| 136 | 146 | doesn't limit the number of active hubs on the network. |
| 137 | − | |
| 147 | + | |
| 138 | 148 | 4. An active hub to another. |
| 139 | 149 | |
| 140 | 150 | 5. An active hub to passive hub. |
| @@ -142,22 +152,22 @@ And now to the cabling. What you can connect together: · 1 unmodified line | ||
| 142 | 152 | Remember that you cannot connect two passive hubs together. The power loss |
| 143 | 153 | implied by such a connection is too high for the net to operate reliably. |
| 144 | 154 | |
| 145 | −An example of a typical ARCnet network: | |
| 155 | +An example of a typical ARCnet network:: | |
| 146 | 156 | |
| 147 | − R S - STAR type card | |
| 157 | + R S - STAR type card | |
| 148 | 158 | S------H--------A-------S R - Terminator |
| 149 | − | | H - Hub | |
| 150 | − | | A - Active hub | |
| 151 | − | S----H----S | |
| 152 | − S | | |
| 153 | − | | |
| 154 | − S | |
| 155 | − | |
| 159 | + | | H - Hub | |
| 160 | + | | A - Active hub | |
| 161 | + | S----H----S | |
| 162 | + S | | |
| 163 | + | | |
| 164 | + S | |
| 165 | + | |
| 156 | 166 | The BUS topology is very similar to the one used by Ethernet. The only |
| 157 | 167 | difference is in cable and terminators: they should be 93 Ohm. Ethernet |
| 158 | 168 | uses 50 Ohm impedance. You use T connectors to put the computers on a single |
| 159 | 169 | line of cable, the bus. You have to put terminators at both ends of the |
| 160 | −cable. A typical BUS ARCnet network looks like: | |
| 170 | +cable. A typical BUS ARCnet network looks like:: | |
| 161 | 171 | |
| 162 | 172 | RT----T------T------T------T------TR |
| 163 | 173 | B B B B B B |
| @@ -168,63 +178,63 @@ cable. A typical BUS ARCnet network looks like: · 4 unmodified lines | ||
| 168 | 178 | |
| 169 | 179 | But that is not all! The two types can be connected together. According to |
| 170 | 180 | the official documentation the only way of connecting them is using an active |
| 171 | −hub: | |
| 181 | +hub:: | |
| 172 | 182 | |
| 173 | − A------T------T------TR | |
| 174 | − | B B B | |
| 183 | + A------T------T------TR | |
| 184 | + | B B B | |
| 175 | 185 | S---H---S |
| 176 | − | | |
| 177 | − S | |
| 186 | + | | |
| 187 | + S | |
| 178 | 188 | |
| 179 | 189 | The official docs also state that you can use STAR cards at the ends of |
| 180 | −BUS network in place of a BUS card and a terminator: | |
| 190 | +BUS network in place of a BUS card and a terminator:: | |
| 181 | 191 | |
| 182 | 192 | S------T------T------S |
| 183 | − B B | |
| 193 | + B B | |
| 184 | 194 | |
| 185 | 195 | But, according to my own experiments, you can simply hang a BUS type card |
| 186 | 196 | anywhere in middle of a cable in a STAR topology network. And more - you |
| 187 | 197 | can use the bus card in place of any star card if you use a terminator. Then |
| 188 | 198 | you can build very complicated networks fulfilling all your needs! An |
| 189 | −example: | |
| 190 | − | |
| 191 | − S | |
| 192 | − | | |
| 193 | − RT------T-------T------H------S | |
| 194 | − B B B | | |
| 195 | − | R | |
| 196 | − S------A------T-------T-------A-------H------TR | |
| 197 | − | B B | | B | |
| 198 | − | S BT | | |
| 199 | − | | | S----A-----S | |
| 200 | − S------H---A----S | | | |
| 201 | − | | S------T----H---S | | |
| 202 | − S S B R S | |
| 203 | − | |
| 199 | +example:: | |
| 200 | + | |
| 201 | + S | |
| 202 | + | | |
| 203 | + RT------T-------T------H------S | |
| 204 | + B B B | | |
| 205 | + | R | |
| 206 | + S------A------T-------T-------A-------H------TR | |
| 207 | + | B B | | B | |
| 208 | + | S BT | | |
| 209 | + | | | S----A-----S | |
| 210 | + S------H---A----S | | | |
| 211 | + | | S------T----H---S | | |
| 212 | + S S B R S | |
| 213 | + | |
| 204 | 214 | A basically different cabling scheme is used with Twisted Pair cabling. Each |
| 205 | 215 | of the TP cards has two RJ (phone-cord style) connectors. The cards are |
| 206 | 216 | then daisy-chained together using a cable connecting every two neighboring |
| 207 | 217 | cards. The ends are terminated with RJ 93 Ohm terminators which plug into |
| 208 | −the empty connectors of cards on the ends of the chain. An example: | |
| 218 | +the empty connectors of cards on the ends of the chain. An example:: | |
| 209 | 219 | |
| 210 | − ___________ ___________ | |
| 211 | − _R_|_ _|_|_ _|_R_ | |
| 212 | − | | | | | | | |
| 213 | − |Card | |Card | |Card | | |
| 214 | − |_____| |_____| |_____| | |
| 220 | + ___________ ___________ | |
| 221 | + _R_|_ _|_|_ _|_R_ | |
| 222 | + | | | | | | | |
| 223 | + |Card | |Card | |Card | | |
| 224 | + |_____| |_____| |_____| | |
| 215 | 225 | |
| 216 | 226 | |
| 217 | 227 | There are also hubs for the TP topology. There is nothing difficult |
| 218 | 228 | involved in using them; you just connect a TP chain to a hub on any end or |
| 219 | −even at both. This way you can create almost any network configuration. | |
| 229 | +even at both. This way you can create almost any network configuration. | |
| 220 | 230 | The maximum of 11 hubs between any two computers on the net applies here as |
| 221 | −well. An example: | |
| 231 | +well. An example:: | |
| 222 | 232 | |
| 223 | 233 | RP-------P--------P--------H-----P------P-----PR |
| 224 | − | | |
| 234 | + | | |
| 225 | 235 | RP-----H--------P--------H-----P------PR |
| 226 | − | | | |
| 227 | − PR PR | |
| 236 | + | | | |
| 237 | + PR PR | |
| 228 | 238 | |
| 229 | 239 | R - RJ Terminator |
| 230 | 240 | P - TP Card |
| @@ -234,11 +244,13 @@ Like any network, ARCnet has a limited cable length. These are the maximum · 3 unmodified lines | ||
| 234 | 244 | cable lengths between two active ends (an active end being an active hub or |
| 235 | 245 | a STAR card). |
| 236 | 246 | |
| 247 | + ========== ======= =========== | |
| 237 | 248 | RG-62 93 Ohm up to 650 m |
| 238 | 249 | RG-59/U 75 Ohm up to 457 m |
| 239 | 250 | RG-11/U 75 Ohm up to 533 m |
| 240 | 251 | IBM Type 1 150 Ohm up to 200 m |
| 241 | 252 | IBM Type 3 100 Ohm up to 100 m |
| 253 | + ========== ======= =========== | |
| 242 | 254 | |
| 243 | 255 | The maximum length of all cables connected to a passive hub is limited to 65 |
| 244 | 256 | meters for RG-62 cabling; less for others. You can see that using passive |
| @@ -248,8 +260,8 @@ most distant points of the net is limited to 3000 meters. The maximum length · 3 unmodified lines | ||
| 248 | 260 | of a TP cable between two cards/hubs is 650 meters. |
| 249 | 261 | |
| 250 | 262 | |
| 251 | −SETTING THE JUMPERS | |
| 252 | −------------------- | |
| 263 | +Setting the Jumpers | |
| 264 | +=================== | |
| 253 | 265 | |
| 254 | 266 | All ARCnet cards should have a total of four or five different settings: |
| 255 | 267 | |
| @@ -261,43 +273,51 @@ All ARCnet cards should have a total of four or five different settings: · 5 unmodified lines | ||
| 261 | 273 | eating net connections on my system (at least) otherwise. My guess is |
| 262 | 274 | this may be because, if your card is at 0x2E0, probing for a serial port |
| 263 | 275 | at 0x2E8 will reset the card and probably mess things up royally. |
| 276 | + | |
| 264 | 277 | - Avery's favourite: 0x300. |
| 265 | 278 | |
| 266 | 279 | - the IRQ: on 8-bit cards, it might be 2 (9), 3, 4, 5, or 7. |
| 267 | − on 16-bit cards, it might be 2 (9), 3, 4, 5, 7, or 10-15. | |
| 268 | − | |
| 280 | + on 16-bit cards, it might be 2 (9), 3, 4, 5, 7, or 10-15. | |
| 281 | + | |
| 269 | 282 | Make sure this is different from any other card on your system. Note |
| 270 | 283 | that IRQ2 is the same as IRQ9, as far as Linux is concerned. You can |
| 271 | 284 | "cat /proc/interrupts" for a somewhat complete list of which ones are in |
| 272 | 285 | use at any given time. Here is a list of common usages from Vojtech |
| 273 | 286 | Pavlik <vojtech@suse.cz>: |
| 274 | − ("Not on bus" means there is no way for a card to generate this | |
| 287 | + | |
| 288 | + ("Not on bus" means there is no way for a card to generate this | |
| 275 | 289 | interrupt) |
| 276 | − IRQ 0 - Timer 0 (Not on bus) | |
| 277 | − IRQ 1 - Keyboard (Not on bus) | |
| 278 | − IRQ 2 - IRQ Controller 2 (Not on bus, nor does interrupt the CPU) | |
| 279 | − IRQ 3 - COM2 | |
| 280 | − IRQ 4 - COM1 | |
| 281 | − IRQ 5 - FREE (LPT2 if you have it; sometimes COM3; maybe PLIP) | |
| 282 | − IRQ 6 - Floppy disk controller | |
| 283 | − IRQ 7 - FREE (LPT1 if you don't use the polling driver; PLIP) | |
| 284 | − IRQ 8 - Realtime Clock Interrupt (Not on bus) | |
| 285 | − IRQ 9 - FREE (VGA vertical sync interrupt if enabled) | |
| 286 | − IRQ 10 - FREE | |
| 287 | − IRQ 11 - FREE | |
| 288 | − IRQ 12 - FREE | |
| 289 | − IRQ 13 - Numeric Coprocessor (Not on bus) | |
| 290 | − IRQ 14 - Fixed Disk Controller | |
| 291 | − IRQ 15 - FREE (Fixed Disk Controller 2 if you have it) | |
| 292 | − | |
| 293 | − Note: IRQ 9 is used on some video cards for the "vertical retrace" | |
| 294 | − interrupt. This interrupt would have been handy for things like | |
| 295 | − video games, as it occurs exactly once per screen refresh, but | |
| 296 | − unfortunately IBM cancelled this feature starting with the original | |
| 297 | − VGA and thus many VGA/SVGA cards do not support it. For this | |
| 298 | − reason, no modern software uses this interrupt and it can almost | |
| 299 | − always be safely disabled, if your video card supports it at all. | |
| 300 | − | |
| 290 | + | |
| 291 | + ====== ========================================================= | |
| 292 | + IRQ 0 Timer 0 (Not on bus) | |
| 293 | + IRQ 1 Keyboard (Not on bus) | |
| 294 | + IRQ 2 IRQ Controller 2 (Not on bus, nor does interrupt the CPU) | |
| 295 | + IRQ 3 COM2 | |
| 296 | + IRQ 4 COM1 | |
| 297 | + IRQ 5 FREE (LPT2 if you have it; sometimes COM3; maybe PLIP) | |
| 298 | + IRQ 6 Floppy disk controller | |
| 299 | + IRQ 7 FREE (LPT1 if you don't use the polling driver; PLIP) | |
| 300 | + IRQ 8 Realtime Clock Interrupt (Not on bus) | |
| 301 | + IRQ 9 FREE (VGA vertical sync interrupt if enabled) | |
| 302 | + IRQ 10 FREE | |
| 303 | + IRQ 11 FREE | |
| 304 | + IRQ 12 FREE | |
| 305 | + IRQ 13 Numeric Coprocessor (Not on bus) | |
| 306 | + IRQ 14 Fixed Disk Controller | |
| 307 | + IRQ 15 FREE (Fixed Disk Controller 2 if you have it) | |
| 308 | + ====== ========================================================= | |
| 309 | + | |
| 310 | + | |
| 311 | + .. note:: | |
| 312 | + | |
| 313 | + IRQ 9 is used on some video cards for the "vertical retrace" | |
| 314 | + interrupt. This interrupt would have been handy for things like | |
| 315 | + video games, as it occurs exactly once per screen refresh, but | |
| 316 | + unfortunately IBM cancelled this feature starting with the original | |
| 317 | + VGA and thus many VGA/SVGA cards do not support it. For this | |
| 318 | + reason, no modern software uses this interrupt and it can almost | |
| 319 | + always be safely disabled, if your video card supports it at all. | |
| 320 | + | |
| 301 | 321 | If your card for some reason CANNOT disable this IRQ (usually there |
| 302 | 322 | is a jumper), one solution would be to clip the printed circuit |
| 303 | 323 | contact on the board: it's the fourth contact from the left on the |
| @@ -308,14 +328,18 @@ All ARCnet cards should have a total of four or five different settings: · 4 unmodified lines | ||
| 308 | 328 | - the memory address: Unlike most cards, ARCnets use "shared memory" for |
| 309 | 329 | copying buffers around. Make SURE it doesn't conflict with any other |
| 310 | 330 | used memory in your system! |
| 331 | + | |
| 332 | + :: | |
| 333 | + | |
| 311 | 334 | A0000 - VGA graphics memory (ok if you don't have VGA) |
| 312 | − B0000 - Monochrome text mode | |
| 313 | − C0000 \ One of these is your VGA BIOS - usually C0000. | |
| 314 | − E0000 / | |
| 315 | − F0000 - System BIOS | |
| 335 | + B0000 - Monochrome text mode | |
| 336 | + C0000 \ One of these is your VGA BIOS - usually C0000. | |
| 337 | + E0000 / | |
| 338 | + F0000 - System BIOS | |
| 316 | 339 | |
| 317 | 340 | Anything less than 0xA0000 is, well, a BAD idea since it isn't above |
| 318 | 341 | 640k. |
| 342 | + | |
| 319 | 343 | - Avery's favourite: 0xD0000 |
| 320 | 344 | |
| 321 | 345 | - the station address: Every ARCnet card has its own "unique" network |
| @@ -326,6 +350,7 @@ All ARCnet cards should have a total of four or five different settings: · 4 unmodified lines | ||
| 326 | 350 | neat stuff will probably happen if you DO use them). By the way, if you |
| 327 | 351 | haven't already guessed, don't set this the same as any other ARCnet on |
| 328 | 352 | your network! |
| 353 | + | |
| 329 | 354 | - Avery's favourite: 3 and 4. Not that it matters. |
| 330 | 355 | |
| 331 | 356 | - There may be ETS1 and ETS2 settings. These may or may not make a |
| @@ -336,28 +361,34 @@ All ARCnet cards should have a total of four or five different settings: · 4 unmodified lines | ||
| 336 | 361 | requirement here is that all cards on the network with ETS1 and ETS2 |
| 337 | 362 | jumpers have them in the same position. Chris Hindy <chrish@io.org> |
| 338 | 363 | sent in a chart with actual values for this: |
| 364 | + | |
| 365 | + ======= ======= =============== ==================== | |
| 339 | 366 | ET1 ET2 Response Time Reconfiguration Time |
| 340 | − --- --- ------------- -------------------- | |
| 367 | + ======= ======= =============== ==================== | |
| 341 | 368 | open open 74.7us 840us |
| 342 | 369 | open closed 283.4us 1680us |
| 343 | 370 | closed open 561.8us 1680us |
| 344 | 371 | closed closed 1118.6us 1680us |
| 345 | − | |
| 372 | + ======= ======= =============== ==================== | |
| 373 | + | |
| 346 | 374 | Make sure you set ETS1 and ETS2 to the SAME VALUE for all cards on your |
| 347 | 375 | network. |
| 348 | − | |
| 349 | −Also, on many cards (not mine, though) there are red and green LED's. | |
| 376 | + | |
| 377 | +Also, on many cards (not mine, though) there are red and green LED's. | |
| 350 | 378 | Vojtech Pavlik <vojtech@suse.cz> tells me this is what they mean: |
| 379 | + | |
| 380 | + =============== =============== ===================================== | |
| 351 | 381 | GREEN RED Status |
| 352 | − ----- --- ------ | |
| 382 | + =============== =============== ===================================== | |
| 353 | 383 | OFF OFF Power off |
| 354 | 384 | OFF Short flashes Cabling problems (broken cable or not |
| 355 | − terminated) | |
| 385 | + terminated) | |
| 356 | 386 | OFF (short) ON Card init |
| 357 | 387 | ON ON Normal state - everything OK, nothing |
| 358 | − happens | |
| 388 | + happens | |
| 359 | 389 | ON Long flashes Data transfer |
| 360 | 390 | ON OFF Never happens (maybe when wrong ID) |
| 391 | + =============== =============== ===================================== | |
| 361 | 392 | |
| 362 | 393 | |
| 363 | 394 | The following is all the specific information people have sent me about |
| @@ -366,7 +397,7 @@ huge amounts of duplicated information. I have no time to fix it. If you · 2 unmodified lines | ||
| 366 | 397 | want to, PLEASE DO! Just send me a 'diff -u' of all your changes. |
| 367 | 398 | |
| 368 | 399 | The model # is listed right above specifics for that card, so you should be |
| 369 | −able to use your text viewer's "search" function to find the entry you want. | |
| 400 | +able to use your text viewer's "search" function to find the entry you want. | |
| 370 | 401 | If you don't KNOW what kind of card you have, try looking through the |
| 371 | 402 | various diagrams to see if you can tell. |
| 372 | 403 | |
| @@ -378,8 +409,9 @@ model that is, please e-mail me to say so. · 5 unmodified lines | ||
| 378 | 409 | |
| 379 | 410 | Cards Listed in this file (in this order, mostly): |
| 380 | 411 | |
| 412 | + =============== ======================= ==== | |
| 381 | 413 | Manufacturer Model # Bits |
| 382 | − ------------ ------- ---- | |
| 414 | + =============== ======================= ==== | |
| 383 | 415 | SMC PC100 8 |
| 384 | 416 | SMC PC110 8 |
| 385 | 417 | SMC PC120 8 |
| @@ -404,17 +436,19 @@ Cards Listed in this file (in this order, mostly): · 18 unmodified lines | ||
| 404 | 436 | No Name Taiwan R.O.C? 8 |
| 405 | 437 | No Name Model 9058 8 |
| 406 | 438 | Tiara Tiara Lancard? 8 |
| 407 | − | |
| 439 | + =============== ======================= ==== | |
| 408 | 440 | |
| 409 | −** SMC = Standard Microsystems Corp. | |
| 410 | −** CNet Tech = CNet Technology, Inc. | |
| 411 | 441 | |
| 442 | +* SMC = Standard Microsystems Corp. | |
| 443 | +* CNet Tech = CNet Technology, Inc. | |
| 412 | 444 | |
| 413 | 445 | Unclassified Stuff |
| 414 | −------------------ | |
| 446 | +================== | |
| 447 | + | |
| 415 | 448 | - Please send any other information you can find. |
| 416 | − | |
| 417 | − - And some other stuff (more info is welcome!): | |
| 449 | + | |
| 450 | + - And some other stuff (more info is welcome!):: | |
| 451 | + | |
| 418 | 452 | From: root@ultraworld.xs4all.nl (Timo Hilbrink) |
| 419 | 453 | To: apenwarr@foxnet.net (Avery Pennarun) |
| 420 | 454 | Date: Wed, 26 Oct 1994 02:10:32 +0000 (GMT) |
| @@ -423,7 +457,7 @@ Unclassified Stuff · 2 unmodified lines | ||
| 423 | 457 | [...parts deleted...] |
| 424 | 458 | |
| 425 | 459 | About the jumpers: On my PC130 there is one more jumper, located near the |
| 426 | − cable-connector and it's for changing to star or bus topology; | |
| 460 | + cable-connector and it's for changing to star or bus topology; | |
| 427 | 461 | closed: star - open: bus |
| 428 | 462 | On the PC500 are some more jumper-pins, one block labeled with RX,PDN,TXI |
| 429 | 463 | and another with ALE,LA17,LA18,LA19 these are undocumented.. |
| @@ -432,136 +466,130 @@ Unclassified Stuff · 2 unmodified lines | ||
| 432 | 466 | |
| 433 | 467 | --- CUT --- |
| 434 | 468 | |
| 469 | +Standard Microsystems Corp (SMC) | |
| 470 | +================================ | |
| 471 | + | |
| 472 | +PC100, PC110, PC120, PC130 (8-bit cards) and PC500, PC600 (16-bit cards) | |
| 473 | +------------------------------------------------------------------------ | |
| 435 | 474 | |
| 436 | −** Standard Microsystems Corp (SMC) ** | |
| 437 | −PC100, PC110, PC120, PC130 (8-bit cards) | |
| 438 | −PC500, PC600 (16-bit cards) | |
| 439 | −--------------------------------- | |
| 440 | 475 | - mainly from Avery Pennarun <apenwarr@worldvisions.ca>. Values depicted |
| 441 | 476 | are from Avery's setup. |
| 442 | 477 | - special thanks to Timo Hilbrink <timoh@xs4all.nl> for noting that PC120, |
| 443 | − 130, 500, and 600 all have the same switches as Avery's PC100. | |
| 478 | + 130, 500, and 600 all have the same switches as Avery's PC100. | |
| 444 | 479 | PC500/600 have several extra, undocumented pins though. (?) |
| 445 | 480 | - PC110 settings were verified by Stephen A. Wood <saw@cebaf.gov> |
| 446 | 481 | - Also, the JP- and S-numbers probably don't match your card exactly. Try |
| 447 | 482 | to find jumpers/switches with the same number of settings - it's |
| 448 | 483 | probably more reliable. |
| 449 | − | |
| 450 | − | |
| 451 | − JP5 [|] : : : : | |
| 452 | −(IRQ Setting) IRQ2 IRQ3 IRQ4 IRQ5 IRQ7 | |
| 453 | − Put exactly one jumper on exactly one set of pins. | |
| 454 | − | |
| 455 | − | |
| 456 | − 1 2 3 4 5 6 7 8 9 10 | |
| 457 | − S1 /----------------------------------\ | |
| 458 | −(I/O and Memory | 1 1 * 0 0 0 0 * 1 1 0 1 | | |
| 459 | − addresses) \----------------------------------/ | |
| 460 | − |--| |--------| |--------| | |
| 461 | − (a) (b) (m) | |
| 462 | − | |
| 463 | − WARNING. It's very important when setting these which way | |
| 464 | − you're holding the card, and which way you think is '1'! | |
| 465 | − | |
| 466 | − If you suspect that your settings are not being made | |
| 467 | − correctly, try reversing the direction or inverting the | |
| 468 | − switch positions. | |
| 469 | − | |
| 470 | − a: The first digit of the I/O address. | |
| 471 | − Setting Value | |
| 472 | − ------- ----- | |
| 473 | − 00 0 | |
| 474 | − 01 1 | |
| 475 | − 10 2 | |
| 476 | − 11 3 | |
| 477 | − | |
| 478 | − b: The second digit of the I/O address. | |
| 479 | − Setting Value | |
| 480 | − ------- ----- | |
| 481 | − 0000 0 | |
| 482 | − 0001 1 | |
| 483 | − 0010 2 | |
| 484 | − ... ... | |
| 485 | − 1110 E | |
| 486 | − 1111 F | |
| 487 | − | |
| 488 | − The I/O address is in the form ab0. For example, if | |
| 489 | − a is 0x2 and b is 0xE, the address will be 0x2E0. | |
| 490 | − | |
| 491 | − DO NOT SET THIS LESS THAN 0x200!!!!! | |
| 492 | − | |
| 493 | − | |
| 494 | − m: The first digit of the memory address. | |
| 495 | − Setting Value | |
| 496 | − ------- ----- | |
| 497 | − 0000 0 | |
| 498 | − 0001 1 | |
| 499 | − 0010 2 | |
| 500 | − ... ... | |
| 501 | − 1110 E | |
| 502 | − 1111 F | |
| 503 | − | |
| 504 | − The memory address is in the form m0000. For example, if | |
| 505 | − m is D, the address will be 0xD0000. | |
| 506 | − | |
| 507 | − DO NOT SET THIS TO C0000, F0000, OR LESS THAN A0000! | |
| 508 | − | |
| 509 | − 1 2 3 4 5 6 7 8 | |
| 510 | − S2 /--------------------------\ | |
| 511 | −(Station Address) | 1 1 0 0 0 0 0 0 | | |
| 512 | − \--------------------------/ | |
| 513 | − | |
| 514 | − Setting Value | |
| 515 | − ------- ----- | |
| 516 | − 00000000 00 | |
| 517 | − 10000000 01 | |
| 518 | − 01000000 02 | |
| 519 | − ... | |
| 520 | − 01111111 FE | |
| 521 | − 11111111 FF | |
| 522 | − | |
| 523 | − Note that this is binary with the digits reversed! | |
| 524 | − | |
| 525 | − DO NOT SET THIS TO 0 OR 255 (0xFF)! | |
| 526 | 484 | |
| 485 | +:: | |
| 486 | + | |
| 487 | + JP5 [|] : : : : | |
| 488 | + (IRQ Setting) IRQ2 IRQ3 IRQ4 IRQ5 IRQ7 | |
| 489 | + Put exactly one jumper on exactly one set of pins. | |
| 490 | + | |
| 491 | + | |
| 492 | + 1 2 3 4 5 6 7 8 9 10 | |
| 493 | + S1 /----------------------------------\ | |
| 494 | + (I/O and Memory | 1 1 * 0 0 0 0 * 1 1 0 1 | | |
| 495 | + addresses) \----------------------------------/ | |
| 496 | + |--| |--------| |--------| | |
| 497 | + (a) (b) (m) | |
| 498 | + | |
| 499 | + WARNING. It's very important when setting these which way | |
| 500 | + you're holding the card, and which way you think is '1'! | |
| 501 | + | |
| 502 | + If you suspect that your settings are not being made | |
| 503 | + correctly, try reversing the direction or inverting the | |
| 504 | + switch positions. | |
| 505 | + | |
| 506 | + a: The first digit of the I/O address. | |
| 507 | + Setting Value | |
| 508 | + ------- ----- | |
| 509 | + 00 0 | |
| 510 | + 01 1 | |
| 511 | + 10 2 | |
| 512 | + 11 3 | |
| 513 | + | |
| 514 | + b: The second digit of the I/O address. | |
| 515 | + Setting Value | |
| 516 | + ------- ----- | |
| 517 | + 0000 0 | |
| 518 | + 0001 1 | |
| 519 | + 0010 2 | |
| 520 | + ... ... | |
| 521 | + 1110 E | |
| 522 | + 1111 F | |
| 523 | + | |
| 524 | + The I/O address is in the form ab0. For example, if | |
| 525 | + a is 0x2 and b is 0xE, the address will be 0x2E0. | |
| 526 | + | |
| 527 | + DO NOT SET THIS LESS THAN 0x200!!!!! | |
| 528 | + | |
| 529 | + | |
| 530 | + m: The first digit of the memory address. | |
| 531 | + Setting Value | |
| 532 | + ------- ----- | |
| 533 | + 0000 0 | |
| 534 | + 0001 1 | |
| 535 | + 0010 2 | |
| 536 | + ... ... | |
| 537 | + 1110 E | |
| 538 | + 1111 F | |
| 539 | + | |
| 540 | + The memory address is in the form m0000. For example, if | |
| 541 | + m is D, the address will be 0xD0000. | |
| 542 | + | |
| 543 | + DO NOT SET THIS TO C0000, F0000, OR LESS THAN A0000! | |
| 544 | + | |
| 545 | + 1 2 3 4 5 6 7 8 | |
| 546 | + S2 /--------------------------\ | |
| 547 | + (Station Address) | 1 1 0 0 0 0 0 0 | | |
| 548 | + \--------------------------/ | |
| 549 | + | |
| 550 | + Setting Value | |
| 551 | + ------- ----- | |
| 552 | + 00000000 00 | |
| 553 | + 10000000 01 | |
| 554 | + 01000000 02 | |
| 555 | + ... | |
| 556 | + 01111111 FE | |
| 557 | + 11111111 FF | |
| 558 | + | |
| 559 | + Note that this is binary with the digits reversed! | |
| 560 | + | |
| 561 | + DO NOT SET THIS TO 0 OR 255 (0xFF)! | |
| 527 | 562 | |
| 528 | −***************************************************************************** | |
| 529 | 563 | |
| 530 | −** Standard Microsystems Corp (SMC) ** | |
| 531 | 564 | PC130E/PC270E (8-bit cards) |
| 532 | 565 | --------------------------- |
| 533 | − - from Juergen Seifert <seifert@htwm.de> | |
| 534 | − | |
| 535 | 566 | |
| 536 | −STANDARD MICROSYSTEMS CORPORATION (SMC) ARCNET(R)-PC130E/PC270E | |
| 537 | −=============================================================== | |
| 567 | + - from Juergen Seifert <seifert@htwm.de> | |
| 538 | 568 | |
| 539 | 569 | This description has been written by Juergen Seifert <seifert@htwm.de> |
| 540 | −using information from the following Original SMC Manual | |
| 570 | +using information from the following Original SMC Manual | |
| 541 | 571 | |
| 542 | − "Configuration Guide for | |
| 543 | − ARCNET(R)-PC130E/PC270 | |
| 544 | − Network Controller Boards | |
| 545 | − Pub. # 900.044A | |
| 546 | − June, 1989" | |
| 572 | + "Configuration Guide for ARCNET(R)-PC130E/PC270 Network | |
| 573 | + Controller Boards Pub. # 900.044A June, 1989" | |
| 547 | 574 | |
| 548 | 575 | ARCNET is a registered trademark of the Datapoint Corporation |
| 549 | −SMC is a registered trademark of the Standard Microsystems Corporation | |
| 576 | +SMC is a registered trademark of the Standard Microsystems Corporation | |
| 550 | 577 | |
| 551 | −The PC130E is an enhanced version of the PC130 board, is equipped with a | |
| 578 | +The PC130E is an enhanced version of the PC130 board, is equipped with a | |
| 552 | 579 | standard BNC female connector for connection to RG-62/U coax cable. |
| 553 | 580 | Since this board is designed both for point-to-point connection in star |
| 554 | −networks and for connection to bus networks, it is downwardly compatible | |
| 581 | +networks and for connection to bus networks, it is downwardly compatible | |
| 555 | 582 | with all the other standard boards designed for coax networks (that is, |
| 556 | −the PC120, PC110 and PC100 star topology boards and the PC220, PC210 and | |
| 583 | +the PC120, PC110 and PC100 star topology boards and the PC220, PC210 and | |
| 557 | 584 | PC200 bus topology boards). |
| 558 | 585 | |
| 559 | −The PC270E is an enhanced version of the PC260 board, is equipped with two | |
| 586 | +The PC270E is an enhanced version of the PC260 board, is equipped with two | |
| 560 | 587 | modular RJ11-type jacks for connection to twisted pair wiring. |
| 561 | 588 | It can be used in a star or a daisy-chained network. |
| 562 | 589 | |
| 590 | +:: | |
| 563 | 591 | |
| 564 | − 8 7 6 5 4 3 2 1 | |
| 592 | + 8 7 6 5 4 3 2 1 | |
| 565 | 593 | ________________________________________________________________ |
| 566 | 594 | | | S1 | | |
| 567 | 595 | | |_________________| | |
| @@ -587,27 +615,27 @@ It can be used in a star or a daisy-chained network. · 19 unmodified lines | ||
| 587 | 615 | | | |
| 588 | 616 | |_____________________________________________| |
| 589 | 617 | |
| 590 | −Legend: | |
| 618 | +Legend:: | |
| 591 | 619 | |
| 592 | −SMC 90C63 ARCNET Controller / Transceiver /Logic | |
| 593 | −S1 1-3: I/O Base Address Select | |
| 620 | + SMC 90C63 ARCNET Controller / Transceiver /Logic | |
| 621 | + S1 1-3: I/O Base Address Select | |
| 594 | 622 | 4-6: Memory Base Address Select |
| 595 | 623 | 7-8: RAM Offset Select |
| 596 | −S2 1-8: Node ID Select | |
| 597 | −EXT Extended Timeout Select | |
| 598 | −ROM ROM Enable Select | |
| 599 | −STAR Selected - Star Topology (PC130E only) | |
| 624 | + S2 1-8: Node ID Select | |
| 625 | + EXT Extended Timeout Select | |
| 626 | + ROM ROM Enable Select | |
| 627 | + STAR Selected - Star Topology (PC130E only) | |
| 600 | 628 | Deselected - Bus Topology (PC130E only) |
| 601 | −CR3/CR4 Diagnostic LEDs | |
| 602 | −J1 BNC RG62/U Connector (PC130E only) | |
| 603 | −J1 6-position Telephone Jack (PC270E only) | |
| 604 | −J2 6-position Telephone Jack (PC270E only) | |
| 629 | + CR3/CR4 Diagnostic LEDs | |
| 630 | + J1 BNC RG62/U Connector (PC130E only) | |
| 631 | + J1 6-position Telephone Jack (PC270E only) | |
| 632 | + J2 6-position Telephone Jack (PC270E only) | |
| 605 | 633 | |
| 606 | 634 | Setting one of the switches to Off/Open means "1", On/Closed means "0". |
| 607 | 635 | |
| 608 | 636 | |
| 609 | 637 | Setting the Node ID |
| 610 | −------------------- | |
| 638 | +^^^^^^^^^^^^^^^^^^^ | |
| 611 | 639 | |
| 612 | 640 | The eight switches in group S2 are used to set the node ID. |
| 613 | 641 | These switches work in a way similar to the PC100-series cards; see that |
| @@ -615,10 +643,10 @@ entry for more information. · 1 unmodified line | ||
| 615 | 643 | |
| 616 | 644 | |
| 617 | 645 | Setting the I/O Base Address |
| 618 | −---------------------------- | |
| 646 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 619 | 647 | |
| 620 | 648 | The first three switches in switch group S1 are used to select one |
| 621 | −of eight possible I/O Base addresses using the following table | |
| 649 | +of eight possible I/O Base addresses using the following table:: | |
| 622 | 650 | |
| 623 | 651 | |
| 624 | 652 | Switch | Hex I/O |
| @@ -635,14 +663,16 @@ of eight possible I/O Base addresses using the following table · 10 unmodified lines | ||
| 635 | 663 | |
| 636 | 664 | |
| 637 | 665 | Setting the Base Memory (RAM) buffer Address |
| 638 | −-------------------------------------------- | |
| 666 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 639 | 667 | |
| 640 | 668 | The memory buffer requires 2K of a 16K block of RAM. The base of this |
| 641 | 669 | 16K block can be located in any of eight positions. |
| 642 | 670 | Switches 4-6 of switch group S1 select the Base of the 16K block. |
| 643 | −Within that 16K address space, the buffer may be assigned any one of four | |
| 671 | +Within that 16K address space, the buffer may be assigned any one of four | |
| 644 | 672 | positions, determined by the offset, switches 7 and 8 of group S1. |
| 645 | 673 | |
| 674 | +:: | |
| 675 | + | |
| 646 | 676 | Switch | Hex RAM | Hex ROM |
| 647 | 677 | 4 5 6 7 8 | Address | Address *) |
| 648 | 678 | -----------|---------|----------- |
| @@ -650,115 +680,111 @@ positions, determined by the offset, switches 7 and 8 of group S1. · 1 unmodified line | ||
| 650 | 680 | 0 0 0 0 1 | C0800 | C2000 |
| 651 | 681 | 0 0 0 1 0 | C1000 | C2000 |
| 652 | 682 | 0 0 0 1 1 | C1800 | C2000 |
| 653 | − | | | |
| 683 | + | | | |
| 654 | 684 | 0 0 1 0 0 | C4000 | C6000 |
| 655 | 685 | 0 0 1 0 1 | C4800 | C6000 |
| 656 | 686 | 0 0 1 1 0 | C5000 | C6000 |
| 657 | 687 | 0 0 1 1 1 | C5800 | C6000 |
| 658 | − | | | |
| 688 | + | | | |
| 659 | 689 | 0 1 0 0 0 | CC000 | CE000 |
| 660 | 690 | 0 1 0 0 1 | CC800 | CE000 |
| 661 | 691 | 0 1 0 1 0 | CD000 | CE000 |
| 662 | 692 | 0 1 0 1 1 | CD800 | CE000 |
| 663 | − | | | |
| 693 | + | | | |
| 664 | 694 | 0 1 1 0 0 | D0000 | D2000 (Manufacturer's default) |
| 665 | 695 | 0 1 1 0 1 | D0800 | D2000 |
| 666 | 696 | 0 1 1 1 0 | D1000 | D2000 |
| 667 | 697 | 0 1 1 1 1 | D1800 | D2000 |
| 668 | − | | | |
| 698 | + | | | |
| 669 | 699 | 1 0 0 0 0 | D4000 | D6000 |
| 670 | 700 | 1 0 0 0 1 | D4800 | D6000 |
| 671 | 701 | 1 0 0 1 0 | D5000 | D6000 |
| 672 | 702 | 1 0 0 1 1 | D5800 | D6000 |
| 673 | − | | | |
| 703 | + | | | |
| 674 | 704 | 1 0 1 0 0 | D8000 | DA000 |
| 675 | 705 | 1 0 1 0 1 | D8800 | DA000 |
| 676 | 706 | 1 0 1 1 0 | D9000 | DA000 |
| 677 | 707 | 1 0 1 1 1 | D9800 | DA000 |
| 678 | − | | | |
| 708 | + | | | |
| 679 | 709 | 1 1 0 0 0 | DC000 | DE000 |
| 680 | 710 | 1 1 0 0 1 | DC800 | DE000 |
| 681 | 711 | 1 1 0 1 0 | DD000 | DE000 |
| 682 | 712 | 1 1 0 1 1 | DD800 | DE000 |
| 683 | − | | | |
| 713 | + | | | |
| 684 | 714 | 1 1 1 0 0 | E0000 | E2000 |
| 685 | 715 | 1 1 1 0 1 | E0800 | E2000 |
| 686 | 716 | 1 1 1 1 0 | E1000 | E2000 |
| 687 | 717 | 1 1 1 1 1 | E1800 | E2000 |
| 688 | − | |
| 689 | −*) To enable the 8K Boot PROM install the jumper ROM. | |
| 690 | − The default is jumper ROM not installed. | |
| 718 | + | |
| 719 | + *) To enable the 8K Boot PROM install the jumper ROM. | |
| 720 | + The default is jumper ROM not installed. | |
| 691 | 721 | |
| 692 | 722 | |
| 693 | 723 | Setting the Timeouts and Interrupt |
| 694 | −---------------------------------- | |
| 724 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 695 | 725 | |
| 696 | −The jumpers labeled EXT1 and EXT2 are used to determine the timeout | |
| 726 | +The jumpers labeled EXT1 and EXT2 are used to determine the timeout | |
| 697 | 727 | parameters. These two jumpers are normally left open. |
| 698 | 728 | |
| 699 | 729 | To select a hardware interrupt level set one (only one!) of the jumpers |
| 700 | 730 | IRQ2, IRQ3, IRQ4, IRQ5, IRQ7. The Manufacturer's default is IRQ2. |
| 701 | − | |
| 731 | + | |
| 702 | 732 | |
| 703 | 733 | Configuring the PC130E for Star or Bus Topology |
| 704 | −----------------------------------------------- | |
| 734 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 705 | 735 | |
| 706 | −The single jumper labeled STAR is used to configure the PC130E board for | |
| 736 | +The single jumper labeled STAR is used to configure the PC130E board for | |
| 707 | 737 | star or bus topology. |
| 708 | −When the jumper is installed, the board may be used in a star network, when | |
| 738 | +When the jumper is installed, the board may be used in a star network, when | |
| 709 | 739 | it is removed, the board can be used in a bus topology. |
| 710 | 740 | |
| 711 | 741 | |
| 712 | 742 | Diagnostic LEDs |
| 713 | −--------------- | |
| 743 | +^^^^^^^^^^^^^^^ | |
| 714 | 744 | |
| 715 | 745 | Two diagnostic LEDs are visible on the rear bracket of the board. |
| 716 | 746 | The green LED monitors the network activity: the red one shows the |
| 717 | −board activity: | |
| 747 | +board activity:: | |
| 718 | 748 | |
| 719 | 749 | Green | Status Red | Status |
| 720 | 750 | -------|------------------- ---------|------------------- |
| 721 | 751 | on | normal activity flash/on | data transfer |
| 722 | 752 | blink | reconfiguration off | no data transfer; |
| 723 | 753 | off | defective board or | incorrect memory or |
| 724 | − | node ID is zero | I/O address | |
| 754 | + | node ID is zero | I/O address | |
| 725 | 755 | |
| 726 | 756 | |
| 727 | −***************************************************************************** | |
| 728 | − | |
| 729 | −** Standard Microsystems Corp (SMC) ** | |
| 730 | 757 | PC500/PC550 Longboard (16-bit cards) |
| 731 | −------------------------------------- | |
| 758 | +------------------------------------ | |
| 759 | + | |
| 732 | 760 | - from Juergen Seifert <seifert@htwm.de> |
| 733 | 761 | |
| 734 | 762 | |
| 735 | −STANDARD MICROSYSTEMS CORPORATION (SMC) ARCNET-PC500/PC550 Long Board | |
| 736 | −===================================================================== | |
| 763 | + .. note:: | |
| 737 | 764 | |
| 738 | −Note: There is another Version of the PC500 called Short Version, which | |
| 765 | + There is another Version of the PC500 called Short Version, which | |
| 739 | 766 | is different in hard- and software! The most important differences |
| 740 | 767 | are: |
| 768 | + | |
| 741 | 769 | - The long board has no Shared memory. |
| 742 | 770 | - On the long board the selection of the interrupt is done by binary |
| 743 | − coded switch, on the short board directly by jumper. | |
| 744 | − | |
| 771 | + coded switch, on the short board directly by jumper. | |
| 772 | + | |
| 745 | 773 | [Avery's note: pay special attention to that: the long board HAS NO SHARED |
| 746 | −MEMORY. This means the current Linux-ARCnet driver can't use these cards. | |
| 774 | +MEMORY. This means the current Linux-ARCnet driver can't use these cards. | |
| 747 | 775 | I have obtained a PC500Longboard and will be doing some experiments on it in |
| 748 | 776 | the future, but don't hold your breath. Thanks again to Juergen Seifert for |
| 749 | 777 | his advice about this!] |
| 750 | 778 | |
| 751 | 779 | This description has been written by Juergen Seifert <seifert@htwm.de> |
| 752 | −using information from the following Original SMC Manual | |
| 780 | +using information from the following Original SMC Manual | |
| 753 | 781 | |
| 754 | − "Configuration Guide for | |
| 755 | − SMC ARCNET-PC500/PC550 | |
| 756 | − Series Network Controller Boards | |
| 757 | − Pub. # 900.033 Rev. A | |
| 758 | − November, 1989" | |
| 782 | + "Configuration Guide for SMC ARCNET-PC500/PC550 | |
| 783 | + Series Network Controller Boards Pub. # 900.033 Rev. A | |
| 784 | + November, 1989" | |
| 759 | 785 | |
| 760 | 786 | ARCNET is a registered trademark of the Datapoint Corporation |
| 761 | −SMC is a registered trademark of the Standard Microsystems Corporation | |
| 787 | +SMC is a registered trademark of the Standard Microsystems Corporation | |
| 762 | 788 | |
| 763 | 789 | The PC500 is equipped with a standard BNC female connector for connection |
| 764 | 790 | to RG-62/U coax cable. |
| @@ -769,7 +795,9 @@ The PC550 is equipped with two modular RJ11-type jacks for connection · 4 unmodified lines | ||
| 769 | 795 | to twisted pair wiring. |
| 770 | 796 | It can be used in a star or a daisy-chained (BUS) network. |
| 771 | 797 | |
| 772 | − 1 | |
| 798 | +:: | |
| 799 | + | |
| 800 | + 1 | |
| 773 | 801 | 0 9 8 7 6 5 4 3 2 1 6 5 4 3 2 1 |
| 774 | 802 | ____________________________________________________________________ |
| 775 | 803 | < | SW1 | | SW2 | | |
| @@ -796,34 +824,34 @@ It can be used in a star or a daisy-chained (BUS) network. · 20 unmodified lines | ||
| 796 | 824 | > | | | |
| 797 | 825 | <____| |_____________________________________________| |
| 798 | 826 | |
| 799 | −Legend: | |
| 827 | +Legend:: | |
| 800 | 828 | |
| 801 | −SW1 1-6: I/O Base Address Select | |
| 829 | + SW1 1-6: I/O Base Address Select | |
| 802 | 830 | 7-10: Interrupt Select |
| 803 | −SW2 1-6: Reserved for Future Use | |
| 804 | −SW3 1-8: Node ID Select | |
| 805 | −JP2 1-4: Extended Timeout Select | |
| 806 | −JP6 Selected - Star Topology (PC500 only) | |
| 831 | + SW2 1-6: Reserved for Future Use | |
| 832 | + SW3 1-8: Node ID Select | |
| 833 | + JP2 1-4: Extended Timeout Select | |
| 834 | + JP6 Selected - Star Topology (PC500 only) | |
| 807 | 835 | Deselected - Bus Topology (PC500 only) |
| 808 | −CR3 Green Monitors Network Activity | |
| 809 | −CR4 Red Monitors Board Activity | |
| 810 | −J1 BNC RG62/U Connector (PC500 only) | |
| 811 | −J1 6-position Telephone Jack (PC550 only) | |
| 812 | −J2 6-position Telephone Jack (PC550 only) | |
| 836 | + CR3 Green Monitors Network Activity | |
| 837 | + CR4 Red Monitors Board Activity | |
| 838 | + J1 BNC RG62/U Connector (PC500 only) | |
| 839 | + J1 6-position Telephone Jack (PC550 only) | |
| 840 | + J2 6-position Telephone Jack (PC550 only) | |
| 813 | 841 | |
| 814 | 842 | Setting one of the switches to Off/Open means "1", On/Closed means "0". |
| 815 | 843 | |
| 816 | 844 | |
| 817 | 845 | Setting the Node ID |
| 818 | −------------------- | |
| 846 | +^^^^^^^^^^^^^^^^^^^ | |
| 819 | 847 | |
| 820 | 848 | The eight switches in group SW3 are used to set the node ID. Each node |
| 821 | −attached to the network must have an unique node ID which must be | |
| 849 | +attached to the network must have an unique node ID which must be | |
| 822 | 850 | different from 0. |
| 823 | 851 | Switch 1 serves as the least significant bit (LSB). |
| 824 | 852 | |
| 825 | −The node ID is the sum of the values of all switches set to "1" | |
| 826 | −These values are: | |
| 853 | +The node ID is the sum of the values of all switches set to "1" | |
| 854 | +These values are:: | |
| 827 | 855 | |
| 828 | 856 | Switch | Value |
| 829 | 857 | -------|------- |
| @@ -836,30 +864,30 @@ These values are: · 6 unmodified lines | ||
| 836 | 864 | 7 | 64 |
| 837 | 865 | 8 | 128 |
| 838 | 866 | |
| 839 | −Some Examples: | |
| 867 | +Some Examples:: | |
| 840 | 868 | |
| 841 | − Switch | Hex | Decimal | |
| 869 | + Switch | Hex | Decimal | |
| 842 | 870 | 8 7 6 5 4 3 2 1 | Node ID | Node ID |
| 843 | 871 | ----------------|---------|--------- |
| 844 | 872 | 0 0 0 0 0 0 0 0 | not allowed |
| 845 | − 0 0 0 0 0 0 0 1 | 1 | 1 | |
| 873 | + 0 0 0 0 0 0 0 1 | 1 | 1 | |
| 846 | 874 | 0 0 0 0 0 0 1 0 | 2 | 2 |
| 847 | 875 | 0 0 0 0 0 0 1 1 | 3 | 3 |
| 848 | 876 | . . . | | |
| 849 | 877 | 0 1 0 1 0 1 0 1 | 55 | 85 |
| 850 | 878 | . . . | | |
| 851 | 879 | 1 0 1 0 1 0 1 0 | AA | 170 |
| 852 | − . . . | | | |
| 880 | + . . . | | | |
| 853 | 881 | 1 1 1 1 1 1 0 1 | FD | 253 |
| 854 | 882 | 1 1 1 1 1 1 1 0 | FE | 254 |
| 855 | − 1 1 1 1 1 1 1 1 | FF | 255 | |
| 883 | + 1 1 1 1 1 1 1 1 | FF | 255 | |
| 856 | 884 | |
| 857 | 885 | |
| 858 | 886 | Setting the I/O Base Address |
| 859 | −---------------------------- | |
| 887 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 860 | 888 | |
| 861 | 889 | The first six switches in switch group SW1 are used to select one |
| 862 | −of 32 possible I/O Base addresses using the following table | |
| 890 | +of 32 possible I/O Base addresses using the following table:: | |
| 863 | 891 | |
| 864 | 892 | Switch | Hex I/O |
| 865 | 893 | 6 5 4 3 2 1 | Address |
| @@ -899,16 +927,18 @@ of 32 possible I/O Base addresses using the following table · 33 unmodified lines | ||
| 899 | 927 | |
| 900 | 928 | |
| 901 | 929 | Setting the Interrupt |
| 902 | −--------------------- | |
| 930 | +^^^^^^^^^^^^^^^^^^^^^ | |
| 903 | 931 | |
| 904 | −Switches seven through ten of switch group SW1 are used to select the | |
| 905 | −interrupt level. The interrupt level is binary coded, so selections | |
| 932 | +Switches seven through ten of switch group SW1 are used to select the | |
| 933 | +interrupt level. The interrupt level is binary coded, so selections | |
| 906 | 934 | from 0 to 15 would be possible, but only the following eight values will |
| 907 | 935 | be supported: 3, 4, 5, 7, 9, 10, 11, 12. |
| 908 | 936 | |
| 937 | +:: | |
| 938 | + | |
| 909 | 939 | Switch | IRQ |
| 910 | − 10 9 8 7 | | |
| 911 | − ---------|-------- | |
| 940 | + 10 9 8 7 | | |
| 941 | + ---------|-------- | |
| 912 | 942 | 0 0 1 1 | 3 |
| 913 | 943 | 0 1 0 0 | 4 |
| 914 | 944 | 0 1 0 1 | 5 |
| @@ -919,52 +949,50 @@ be supported: 3, 4, 5, 7, 9, 10, 11, 12. · 4 unmodified lines | ||
| 919 | 949 | 1 1 0 0 | 12 |
| 920 | 950 | |
| 921 | 951 | |
| 922 | −Setting the Timeouts | |
| 923 | −-------------------- | |
| 952 | +Setting the Timeouts | |
| 953 | +^^^^^^^^^^^^^^^^^^^^ | |
| 924 | 954 | |
| 925 | −The two jumpers JP2 (1-4) are used to determine the timeout parameters. | |
| 955 | +The two jumpers JP2 (1-4) are used to determine the timeout parameters. | |
| 926 | 956 | These two jumpers are normally left open. |
| 927 | 957 | Refer to the COM9026 Data Sheet for alternate configurations. |
| 928 | 958 | |
| 929 | 959 | |
| 930 | 960 | Configuring the PC500 for Star or Bus Topology |
| 931 | −---------------------------------------------- | |
| 961 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 932 | 962 | |
| 933 | −The single jumper labeled JP6 is used to configure the PC500 board for | |
| 963 | +The single jumper labeled JP6 is used to configure the PC500 board for | |
| 934 | 964 | star or bus topology. |
| 935 | −When the jumper is installed, the board may be used in a star network, when | |
| 965 | +When the jumper is installed, the board may be used in a star network, when | |
| 936 | 966 | it is removed, the board can be used in a bus topology. |
| 937 | 967 | |
| 938 | 968 | |
| 939 | 969 | Diagnostic LEDs |
| 940 | −--------------- | |
| 970 | +^^^^^^^^^^^^^^^ | |
| 941 | 971 | |
| 942 | 972 | Two diagnostic LEDs are visible on the rear bracket of the board. |
| 943 | 973 | The green LED monitors the network activity: the red one shows the |
| 944 | −board activity: | |
| 974 | +board activity:: | |
| 945 | 975 | |
| 946 | 976 | Green | Status Red | Status |
| 947 | 977 | -------|------------------- ---------|------------------- |
| 948 | 978 | on | normal activity flash/on | data transfer |
| 949 | 979 | blink | reconfiguration off | no data transfer; |
| 950 | 980 | off | defective board or | incorrect memory or |
| 951 | − | node ID is zero | I/O address | |
| 981 | + | node ID is zero | I/O address | |
| 952 | 982 | |
| 953 | 983 | |
| 954 | −***************************************************************************** | |
| 955 | − | |
| 956 | −** SMC ** | |
| 957 | 984 | PC710 (8-bit card) |
| 958 | 985 | ------------------ |
| 986 | + | |
| 959 | 987 | - from J.S. van Oosten <jvoosten@compiler.tdcnet.nl> |
| 960 | − | |
| 988 | + | |
| 961 | 989 | Note: this data is gathered by experimenting and looking at info of other |
| 962 | 990 | cards. However, I'm sure I got 99% of the settings right. |
| 963 | 991 | |
| 964 | 992 | The SMC710 card resembles the PC270 card, but is much more basic (i.e. no |
| 965 | −LEDs, RJ11 jacks, etc.) and 8 bit. Here's a little drawing: | |
| 993 | +LEDs, RJ11 jacks, etc.) and 8 bit. Here's a little drawing:: | |
| 966 | 994 | |
| 967 | − _______________________________________ | |
| 995 | + _______________________________________ | |
| 968 | 996 | | +---------+ +---------+ |____ |
| 969 | 997 | | | S2 | | S1 | | |
| 970 | 998 | | +---------+ +---------+ | |
| @@ -976,12 +1004,12 @@ LEDs, RJ11 jacks, etc.) and 8 bit. Here's a little drawing: · 5 unmodified lines | ||
| 976 | 1004 | | +===+ | |
| 977 | 1005 | | | |
| 978 | 1006 | | .. JP1 +----------+ | |
| 979 | − | .. | big chip | | | |
| 1007 | + | .. | big chip | | | |
| 980 | 1008 | | .. | 90C63 | | |
| 981 | 1009 | | .. | | | |
| 982 | 1010 | | .. +----------+ | |
| 983 | 1011 | ------- ----------- |
| 984 | − ||||||||||||||||||||| | |
| 1012 | + ||||||||||||||||||||| | |
| 985 | 1013 | |
| 986 | 1014 | The row of jumpers at JP1 actually consists of 8 jumpers, (sometimes |
| 987 | 1015 | labelled) the same as on the PC270, from top to bottom: EXT2, EXT1, ROM, |
| @@ -992,71 +1020,76 @@ are swapped (S1 is the nodeaddress, S2 sets IO- and RAM-address). · 4 unmodified lines | ||
| 992 | 1020 | |
| 993 | 1021 | I know it works when connected to a PC110 type ARCnet board. |
| 994 | 1022 | |
| 995 | − | |
| 1023 | + | |
| 996 | 1024 | ***************************************************************************** |
| 997 | 1025 | |
| 998 | −** Possibly SMC ** | |
| 1026 | +Possibly SMC | |
| 1027 | +============ | |
| 1028 | + | |
| 999 | 1029 | LCS-8830(-T) (8 and 16-bit cards) |
| 1000 | 1030 | --------------------------------- |
| 1031 | + | |
| 1001 | 1032 | - from Mathias Katzer <mkatzer@HRZ.Uni-Bielefeld.DE> |
| 1002 | 1033 | - Marek Michalkiewicz <marekm@i17linuxb.ists.pwr.wroc.pl> says the |
| 1003 | 1034 | LCS-8830 is slightly different from LCS-8830-T. These are 8 bit, BUS |
| 1004 | 1035 | only (the JP0 jumper is hardwired), and BNC only. |
| 1005 | − | |
| 1036 | + | |
| 1006 | 1037 | This is a LCS-8830-T made by SMC, I think ('SMC' only appears on one PLCC, |
| 1007 | 1038 | nowhere else, not even on the few Xeroxed sheets from the manual). |
| 1008 | 1039 | |
| 1009 | −SMC ARCnet Board Type LCS-8830-T | |
| 1040 | +SMC ARCnet Board Type LCS-8830-T:: | |
| 1010 | 1041 | |
| 1011 | − ------------------------------------ | |
| 1012 | − | | | |
| 1013 | − | JP3 88 8 JP2 | | |
| 1014 | − | ##### | \ | | |
| 1015 | − | ##### ET1 ET2 ###| | |
| 1016 | − | 8 ###| | |
| 1017 | − | U3 SW 1 JP0 ###| Phone Jacks | |
| 1018 | − | -- ###| | |
| 1019 | − | | | | | |
| 1020 | − | | | SW2 | | |
| 1021 | − | | | | | |
| 1022 | − | | | ##### | | |
| 1023 | − | -- ##### #### BNC Connector | |
| 1024 | − | #### | |
| 1025 | − | 888888 JP1 | | |
| 1026 | − | 234567 | | |
| 1027 | − -- ------- | |
| 1028 | − ||||||||||||||||||||||||||| | |
| 1029 | − -------------------------- | |
| 1030 | − | |
| 1031 | − | |
| 1032 | −SW1: DIP-Switches for Station Address | |
| 1033 | −SW2: DIP-Switches for Memory Base and I/O Base addresses | |
| 1034 | − | |
| 1035 | −JP0: If closed, internal termination on (default open) | |
| 1036 | −JP1: IRQ Jumpers | |
| 1037 | −JP2: Boot-ROM enabled if closed | |
| 1038 | −JP3: Jumpers for response timeout | |
| 1039 | − | |
| 1040 | −U3: Boot-ROM Socket | |
| 1041 | − | |
| 1042 | − | |
| 1043 | −ET1 ET2 Response Time Idle Time Reconfiguration Time | |
| 1044 | − | |
| 1045 | − 78 86 840 | |
| 1046 | − X 285 316 1680 | |
| 1047 | − X 563 624 1680 | |
| 1048 | − X X 1130 1237 1680 | |
| 1049 | − | |
| 1050 | −(X means closed jumper) | |
| 1051 | − | |
| 1052 | −(DIP-Switch downwards means "0") | |
| 1042 | + ------------------------------------ | |
| 1043 | + | | | |
| 1044 | + | JP3 88 8 JP2 | | |
| 1045 | + | ##### | \ | | |
| 1046 | + | ##### ET1 ET2 ###| | |
| 1047 | + | 8 ###| | |
| 1048 | + | U3 SW 1 JP0 ###| Phone Jacks | |
| 1049 | + | -- ###| | |
| 1050 | + | | | | | |
| 1051 | + | | | SW2 | | |
| 1052 | + | | | | | |
| 1053 | + | | | ##### | | |
| 1054 | + | -- ##### #### BNC Connector | |
| 1055 | + | #### | |
| 1056 | + | 888888 JP1 | | |
| 1057 | + | 234567 | | |
| 1058 | + -- ------- | |
| 1059 | + ||||||||||||||||||||||||||| | |
| 1060 | + -------------------------- | |
| 1061 | + | |
| 1062 | + | |
| 1063 | + SW1: DIP-Switches for Station Address | |
| 1064 | + SW2: DIP-Switches for Memory Base and I/O Base addresses | |
| 1065 | + | |
| 1066 | + JP0: If closed, internal termination on (default open) | |
| 1067 | + JP1: IRQ Jumpers | |
| 1068 | + JP2: Boot-ROM enabled if closed | |
| 1069 | + JP3: Jumpers for response timeout | |
| 1070 | + | |
| 1071 | + U3: Boot-ROM Socket | |
| 1072 | + | |
| 1073 | + | |
| 1074 | + ET1 ET2 Response Time Idle Time Reconfiguration Time | |
| 1075 | + | |
| 1076 | + 78 86 840 | |
| 1077 | + X 285 316 1680 | |
| 1078 | + X 563 624 1680 | |
| 1079 | + X X 1130 1237 1680 | |
| 1080 | + | |
| 1081 | + (X means closed jumper) | |
| 1082 | + | |
| 1083 | + (DIP-Switch downwards means "0") | |
| 1053 | 1084 | |
| 1054 | 1085 | The station address is binary-coded with SW1. |
| 1055 | 1086 | |
| 1056 | 1087 | The I/O base address is coded with DIP-Switches 6,7 and 8 of SW2: |
| 1057 | 1088 | |
| 1089 | +======== ======== | |
| 1058 | 1090 | Switches Base |
| 1059 | 1091 | 678 Address |
| 1092 | +======== ======== | |
| 1060 | 1093 | 000 260-26f |
| 1061 | 1094 | 100 290-29f |
| 1062 | 1095 | 010 2e0-2ef |
| @@ -1065,19 +1098,22 @@ Switches Base · 2 unmodified lines | ||
| 1065 | 1098 | 101 350-35f |
| 1066 | 1099 | 011 380-38f |
| 1067 | 1100 | 111 3e0-3ef |
| 1101 | +======== ======== | |
| 1068 | 1102 | |
| 1069 | 1103 | |
| 1070 | 1104 | DIP Switches 1-5 of SW2 encode the RAM and ROM Address Range: |
| 1071 | 1105 | |
| 1106 | +======== ============= ================ | |
| 1072 | 1107 | Switches RAM ROM |
| 1073 | 1108 | 12345 Address Range Address Range |
| 1109 | +======== ============= ================ | |
| 1074 | 1110 | 00000 C:0000-C:07ff C:2000-C:3fff |
| 1075 | 1111 | 10000 C:0800-C:0fff |
| 1076 | 1112 | 01000 C:1000-C:17ff |
| 1077 | 1113 | 11000 C:1800-C:1fff |
| 1078 | 1114 | 00100 C:4000-C:47ff C:6000-C:7fff |
| 1079 | 1115 | 10100 C:4800-C:4fff |
| 1080 | −01100 C:5000-C:57ff | |
| 1116 | +01100 C:5000-C:57ff | |
| 1081 | 1117 | 11100 C:5800-C:5fff |
| 1082 | 1118 | 00010 C:C000-C:C7ff C:E000-C:ffff |
| 1083 | 1119 | 10010 C:C800-C:Cfff |
| @@ -1094,7 +1130,7 @@ Switches RAM ROM · 10 unmodified lines | ||
| 1094 | 1130 | 00101 D:8000-D:87ff D:A000-D:bfff |
| 1095 | 1131 | 10101 D:8800-D:8fff |
| 1096 | 1132 | 01101 D:9000-D:97ff |
| 1097 | −11101 D:9800-D:9fff | |
| 1133 | +11101 D:9800-D:9fff | |
| 1098 | 1134 | 00011 D:C000-D:c7ff D:E000-D:ffff |
| 1099 | 1135 | 10011 D:C800-D:cfff |
| 1100 | 1136 | 01011 D:D000-D:d7ff |
| @@ -1103,34 +1139,37 @@ Switches RAM ROM · 2 unmodified lines | ||
| 1103 | 1139 | 10111 E:0800-E:0fff |
| 1104 | 1140 | 01111 E:1000-E:17ff |
| 1105 | 1141 | 11111 E:1800-E:1fff |
| 1142 | +======== ============= ================ | |
| 1106 | 1143 | |
| 1107 | 1144 | |
| 1108 | −***************************************************************************** | |
| 1145 | +PureData Corp | |
| 1146 | +============= | |
| 1109 | 1147 | |
| 1110 | −** PureData Corp ** | |
| 1111 | 1148 | PDI507 (8-bit card) |
| 1112 | 1149 | -------------------- |
| 1150 | + | |
| 1113 | 1151 | - from Mark Rejhon <mdrejhon@magi.com> (slight modifications by Avery) |
| 1114 | 1152 | - Avery's note: I think PDI508 cards (but definitely NOT PDI508Plus cards) |
| 1115 | 1153 | are mostly the same as this. PDI508Plus cards appear to be mainly |
| 1116 | 1154 | software-configured. |
| 1117 | 1155 | |
| 1118 | 1156 | Jumpers: |
| 1157 | + | |
| 1119 | 1158 | There is a jumper array at the bottom of the card, near the edge |
| 1120 | − connector. This array is labelled J1. They control the IRQs and | |
| 1121 | − something else. Put only one jumper on the IRQ pins. | |
| 1159 | + connector. This array is labelled J1. They control the IRQs and | |
| 1160 | + something else. Put only one jumper on the IRQ pins. | |
| 1122 | 1161 | |
| 1123 | 1162 | ETS1, ETS2 are for timing on very long distance networks. See the |
| 1124 | 1163 | more general information near the top of this file. |
| 1125 | 1164 | |
| 1126 | 1165 | There is a J2 jumper on two pins. A jumper should be put on them, |
| 1127 | − since it was already there when I got the card. I don't know what | |
| 1128 | − this jumper is for though. | |
| 1166 | + since it was already there when I got the card. I don't know what | |
| 1167 | + this jumper is for though. | |
| 1129 | 1168 | |
| 1130 | 1169 | There is a two-jumper array for J3. I don't know what it is for, |
| 1131 | − but there were already two jumpers on it when I got the card. It's | |
| 1132 | − a six pin grid in a two-by-three fashion. The jumpers were | |
| 1133 | − configured as follows: | |
| 1170 | + but there were already two jumpers on it when I got the card. It's | |
| 1171 | + a six pin grid in a two-by-three fashion. The jumpers were | |
| 1172 | + configured as follows:: | |
| 1134 | 1173 | |
| 1135 | 1174 | .-------. |
| 1136 | 1175 | o | o o | |
| @@ -1140,28 +1179,28 @@ Jumpers: · 3 unmodified lines | ||
| 1140 | 1179 | |
| 1141 | 1180 | Carl de Billy <CARL@carainfo.com> explains J3 and J4: |
| 1142 | 1181 | |
| 1143 | − J3 Diagram: | |
| 1182 | + J3 Diagram:: | |
| 1144 | 1183 | |
| 1145 | − .-------. | |
| 1146 | − o | o o | | |
| 1147 | − :-------: TWIST Technology | |
| 1148 | − o | o o | | |
| 1149 | − `-------' | |
| 1150 | − .-------. | |
| 1151 | − | o o | o | |
| 1152 | − :-------: COAX Technology | |
| 1153 | − | o o | o | |
| 1154 | − `-------' | |
| 1184 | + .-------. | |
| 1185 | + o | o o | | |
| 1186 | + :-------: TWIST Technology | |
| 1187 | + o | o o | | |
| 1188 | + `-------' | |
| 1189 | + .-------. | |
| 1190 | + | o o | o | |
| 1191 | + :-------: COAX Technology | |
| 1192 | + | o o | o | |
| 1193 | + `-------' | |
| 1155 | 1194 | |
| 1156 | 1195 | - If using coax cable in a bus topology the J4 jumper must be removed; |
| 1157 | 1196 | place it on one pin. |
| 1158 | 1197 | |
| 1159 | − - If using bus topology with twisted pair wiring move the J3 | |
| 1198 | + - If using bus topology with twisted pair wiring move the J3 | |
| 1160 | 1199 | jumpers so they connect the middle pin and the pins closest to the RJ11 |
| 1161 | 1200 | Connectors. Also the J4 jumper must be removed; place it on one pin of |
| 1162 | 1201 | J4 jumper for storage. |
| 1163 | 1202 | |
| 1164 | − - If using star topology with twisted pair wiring move the J3 | |
| 1203 | + - If using star topology with twisted pair wiring move the J3 | |
| 1165 | 1204 | jumpers so they connect the middle pin and the pins closest to the RJ11 |
| 1166 | 1205 | connectors. |
| 1167 | 1206 | |
| @@ -1169,40 +1208,43 @@ Carl de Billy <CARL@carainfo.com> explains J3 and J4: · 1 unmodified line | ||
| 1169 | 1208 | DIP Switches: |
| 1170 | 1209 | |
| 1171 | 1210 | The DIP switches accessible on the accessible end of the card while |
| 1172 | − it is installed, is used to set the ARCnet address. There are 8 | |
| 1173 | − switches. Use an address from 1 to 254. | |
| 1211 | + it is installed, is used to set the ARCnet address. There are 8 | |
| 1212 | + switches. Use an address from 1 to 254 | |
| 1174 | 1213 | |
| 1175 | − Switch No. | |
| 1176 | − 12345678 ARCnet address | |
| 1177 | − ----------------------------------------- | |
| 1214 | + ========== ========================= | |
| 1215 | + Switch No. ARCnet address | |
| 1216 | + 12345678 | |
| 1217 | + ========== ========================= | |
| 1178 | 1218 | 00000000 FF (Don't use this!) |
| 1179 | 1219 | 00000001 FE |
| 1180 | 1220 | 00000010 FD |
| 1181 | − .... | |
| 1182 | − 11111101 2 | |
| 1221 | + ... | |
| 1222 | + 11111101 2 | |
| 1183 | 1223 | 11111110 1 |
| 1184 | 1224 | 11111111 0 (Don't use this!) |
| 1225 | + ========== ========================= | |
| 1185 | 1226 | |
| 1186 | 1227 | There is another array of eight DIP switches at the top of the |
| 1187 | − card. There are five labelled MS0-MS4 which seem to control the | |
| 1188 | − memory address, and another three labelled IO0-IO2 which seem to | |
| 1189 | − control the base I/O address of the card. | |
| 1228 | + card. There are five labelled MS0-MS4 which seem to control the | |
| 1229 | + memory address, and another three labelled IO0-IO2 which seem to | |
| 1230 | + control the base I/O address of the card. | |
| 1190 | 1231 | |
| 1191 | 1232 | This was difficult to test by trial and error, and the I/O addresses |
| 1192 | − are in a weird order. This was tested by setting the DIP switches, | |
| 1193 | − rebooting the computer, and attempting to load ARCETHER at various | |
| 1194 | − addresses (mostly between 0x200 and 0x400). The address that caused | |
| 1195 | − the red transmit LED to blink, is the one that I thought works. | |
| 1233 | + are in a weird order. This was tested by setting the DIP switches, | |
| 1234 | + rebooting the computer, and attempting to load ARCETHER at various | |
| 1235 | + addresses (mostly between 0x200 and 0x400). The address that caused | |
| 1236 | + the red transmit LED to blink, is the one that I thought works. | |
| 1196 | 1237 | |
| 1197 | 1238 | Also, the address 0x3D0 seem to have a special meaning, since the |
| 1198 | − ARCETHER packet driver loaded fine, but without the red LED | |
| 1199 | − blinking. I don't know what 0x3D0 is for though. I recommend using | |
| 1200 | − an address of 0x300 since Windows may not like addresses below | |
| 1201 | − 0x300. | |
| 1202 | − | |
| 1203 | − IO Switch No. | |
| 1204 | − 210 I/O address | |
| 1205 | − ------------------------------- | |
| 1239 | + ARCETHER packet driver loaded fine, but without the red LED | |
| 1240 | + blinking. I don't know what 0x3D0 is for though. I recommend using | |
| 1241 | + an address of 0x300 since Windows may not like addresses below | |
| 1242 | + 0x300. | |
| 1243 | + | |
| 1244 | + ============= =========== | |
| 1245 | + IO Switch No. I/O address | |
| 1246 | + 210 | |
| 1247 | + ============= =========== | |
| 1206 | 1248 | 111 0x260 |
| 1207 | 1249 | 110 0x290 |
| 1208 | 1250 | 101 0x2E0 |
| @@ -1211,29 +1253,31 @@ DIP Switches: · 2 unmodified lines | ||
| 1211 | 1253 | 010 0x350 |
| 1212 | 1254 | 001 0x380 |
| 1213 | 1255 | 000 0x3E0 |
| 1256 | + ============= =========== | |
| 1214 | 1257 | |
| 1215 | 1258 | The memory switches set a reserved address space of 0x1000 bytes |
| 1216 | − (0x100 segment units, or 4k). For example if I set an address of | |
| 1217 | − 0xD000, it will use up addresses 0xD000 to 0xD100. | |
| 1259 | + (0x100 segment units, or 4k). For example if I set an address of | |
| 1260 | + 0xD000, it will use up addresses 0xD000 to 0xD100. | |
| 1218 | 1261 | |
| 1219 | 1262 | The memory switches were tested by booting using QEMM386 stealth, |
| 1220 | − and using LOADHI to see what address automatically became excluded | |
| 1221 | − from the upper memory regions, and then attempting to load ARCETHER | |
| 1222 | − using these addresses. | |
| 1263 | + and using LOADHI to see what address automatically became excluded | |
| 1264 | + from the upper memory regions, and then attempting to load ARCETHER | |
| 1265 | + using these addresses. | |
| 1223 | 1266 | |
| 1224 | 1267 | I recommend using an ARCnet memory address of 0xD000, and putting |
| 1225 | − the EMS page frame at 0xC000 while using QEMM stealth mode. That | |
| 1226 | − way, you get contiguous high memory from 0xD100 almost all the way | |
| 1227 | − the end of the megabyte. | |
| 1268 | + the EMS page frame at 0xC000 while using QEMM stealth mode. That | |
| 1269 | + way, you get contiguous high memory from 0xD100 almost all the way | |
| 1270 | + the end of the megabyte. | |
| 1228 | 1271 | |
| 1229 | 1272 | Memory Switch 0 (MS0) didn't seem to work properly when set to OFF |
| 1230 | − on my card. It could be malfunctioning on my card. Experiment with | |
| 1231 | − it ON first, and if it doesn't work, set it to OFF. (It may be a | |
| 1232 | − modifier for the 0x200 bit?) | |
| 1273 | + on my card. It could be malfunctioning on my card. Experiment with | |
| 1274 | + it ON first, and if it doesn't work, set it to OFF. (It may be a | |
| 1275 | + modifier for the 0x200 bit?) | |
| 1233 | 1276 | |
| 1277 | + ============= ============================================ | |
| 1234 | 1278 | MS Switch No. |
| 1235 | 1279 | 43210 Memory address |
| 1236 | − -------------------------------- | |
| 1280 | + ============= ============================================ | |
| 1237 | 1281 | 00001 0xE100 (guessed - was not detected by QEMM) |
| 1238 | 1282 | 00011 0xE000 (guessed - was not detected by QEMM) |
| 1239 | 1283 | 00101 0xDD00 |
| @@ -1250,40 +1294,36 @@ DIP Switches: · 10 unmodified lines | ||
| 1250 | 1294 | 11011 0xC800 (guessed - crashes tested system) |
| 1251 | 1295 | 11101 0xC500 (guessed - crashes tested system) |
| 1252 | 1296 | 11111 0xC400 (guessed - crashes tested system) |
| 1253 | − | |
| 1254 | − | |
| 1255 | −***************************************************************************** | |
| 1297 | + ============= ============================================ | |
| 1298 | + | |
| 1299 | +CNet Technology Inc. (8-bit cards) | |
| 1300 | +================================== | |
| 1256 | 1301 | |
| 1257 | −** CNet Technology Inc. ** | |
| 1258 | 1302 | 120 Series (8-bit cards) |
| 1259 | 1303 | ------------------------ |
| 1260 | 1304 | - from Juergen Seifert <seifert@htwm.de> |
| 1261 | 1305 | |
| 1262 | − | |
| 1263 | −CNET TECHNOLOGY INC. (CNet) ARCNET 120A SERIES | |
| 1264 | −============================================== | |
| 1265 | − | |
| 1266 | 1306 | This description has been written by Juergen Seifert <seifert@htwm.de> |
| 1267 | −using information from the following Original CNet Manual | |
| 1268 | − | |
| 1269 | − "ARCNET | |
| 1270 | − USER'S MANUAL | |
| 1271 | − for | |
| 1272 | − CN120A | |
| 1273 | − CN120AB | |
| 1274 | − CN120TP | |
| 1275 | − CN120ST | |
| 1276 | − CN120SBT | |
| 1277 | − P/N:12-01-0007 | |
| 1278 | − Revision 3.00" | |
| 1307 | +using information from the following Original CNet Manual | |
| 1308 | + | |
| 1309 | + "ARCNET USER'S MANUAL for | |
| 1310 | + CN120A | |
| 1311 | + CN120AB | |
| 1312 | + CN120TP | |
| 1313 | + CN120ST | |
| 1314 | + CN120SBT | |
| 1315 | + P/N:12-01-0007 | |
| 1316 | + Revision 3.00" | |
| 1279 | 1317 | |
| 1280 | 1318 | ARCNET is a registered trademark of the Datapoint Corporation |
| 1281 | 1319 | |
| 1282 | −P/N 120A ARCNET 8 bit XT/AT Star | |
| 1283 | −P/N 120AB ARCNET 8 bit XT/AT Bus | |
| 1284 | −P/N 120TP ARCNET 8 bit XT/AT Twisted Pair | |
| 1285 | −P/N 120ST ARCNET 8 bit XT/AT Star, Twisted Pair | |
| 1286 | −P/N 120SBT ARCNET 8 bit XT/AT Star, Bus, Twisted Pair | |
| 1320 | +- P/N 120A ARCNET 8 bit XT/AT Star | |
| 1321 | +- P/N 120AB ARCNET 8 bit XT/AT Bus | |
| 1322 | +- P/N 120TP ARCNET 8 bit XT/AT Twisted Pair | |
| 1323 | +- P/N 120ST ARCNET 8 bit XT/AT Star, Twisted Pair | |
| 1324 | +- P/N 120SBT ARCNET 8 bit XT/AT Star, Bus, Twisted Pair | |
| 1325 | + | |
| 1326 | +:: | |
| 1287 | 1327 | |
| 1288 | 1328 | __________________________________________________________________ |
| 1289 | 1329 | | | |
| @@ -1307,75 +1347,77 @@ P/N 120SBT ARCNET 8 bit XT/AT Star, Bus, Twisted Pair · 17 unmodified lines | ||
| 1307 | 1347 | | > SOCKET | JP 6 5 4 3 2 |o|o|o| | J1 | |
| 1308 | 1348 | | |______________| |o|o|o|o|o| |o|o|o| |_____| |
| 1309 | 1349 | |_____ |o|o|o|o|o| ______________| |
| 1310 | − | | | |
| 1311 | − |_____________________________________________| | |
| 1312 | − | |
| 1313 | −Legend: | |
| 1314 | − | |
| 1315 | −90C65 ARCNET Probe | |
| 1316 | −S1 1-5: Base Memory Address Select | |
| 1317 | − 6-8: Base I/O Address Select | |
| 1318 | −S2 1-8: Node ID Select (ID0-ID7) | |
| 1319 | −JP1 ROM Enable Select | |
| 1320 | −JP2 IRQ2 | |
| 1321 | −JP3 IRQ3 | |
| 1322 | −JP4 IRQ4 | |
| 1323 | −JP5 IRQ5 | |
| 1324 | −JP6 IRQ7 | |
| 1325 | −JP7/JP8 ET1, ET2 Timeout Parameters | |
| 1326 | −JP10/JP11 Coax / Twisted Pair Select (CN120ST/SBT only) | |
| 1327 | −JP12 Terminator Select (CN120AB/ST/SBT only) | |
| 1328 | −J1 BNC RG62/U Connector (all except CN120TP) | |
| 1329 | −J2 Two 6-position Telephone Jack (CN120TP/ST/SBT only) | |
| 1350 | + | | | |
| 1351 | + |_____________________________________________| | |
| 1352 | + | |
| 1353 | +Legend:: | |
| 1354 | + | |
| 1355 | + 90C65 ARCNET Probe | |
| 1356 | + S1 1-5: Base Memory Address Select | |
| 1357 | + 6-8: Base I/O Address Select | |
| 1358 | + S2 1-8: Node ID Select (ID0-ID7) | |
| 1359 | + JP1 ROM Enable Select | |
| 1360 | + JP2 IRQ2 | |
| 1361 | + JP3 IRQ3 | |
| 1362 | + JP4 IRQ4 | |
| 1363 | + JP5 IRQ5 | |
| 1364 | + JP6 IRQ7 | |
| 1365 | + JP7/JP8 ET1, ET2 Timeout Parameters | |
| 1366 | + JP10/JP11 Coax / Twisted Pair Select (CN120ST/SBT only) | |
| 1367 | + JP12 Terminator Select (CN120AB/ST/SBT only) | |
| 1368 | + J1 BNC RG62/U Connector (all except CN120TP) | |
| 1369 | + J2 Two 6-position Telephone Jack (CN120TP/ST/SBT only) | |
| 1330 | 1370 | |
| 1331 | 1371 | Setting one of the switches to Off means "1", On means "0". |
| 1332 | 1372 | |
| 1333 | 1373 | |
| 1334 | 1374 | Setting the Node ID |
| 1335 | −------------------- | |
| 1375 | +^^^^^^^^^^^^^^^^^^^ | |
| 1336 | 1376 | |
| 1337 | 1377 | The eight switches in SW2 are used to set the node ID. Each node attached |
| 1338 | 1378 | to the network must have an unique node ID which must be different from 0. |
| 1339 | 1379 | Switch 1 (ID0) serves as the least significant bit (LSB). |
| 1340 | 1380 | |
| 1341 | −The node ID is the sum of the values of all switches set to "1" | |
| 1381 | +The node ID is the sum of the values of all switches set to "1" | |
| 1342 | 1382 | These values are: |
| 1343 | 1383 | |
| 1344 | − Switch | Label | Value | |
| 1345 | − -------|-------|------- | |
| 1346 | − 1 | ID0 | 1 | |
| 1347 | − 2 | ID1 | 2 | |
| 1348 | − 3 | ID2 | 4 | |
| 1349 | − 4 | ID3 | 8 | |
| 1350 | − 5 | ID4 | 16 | |
| 1351 | − 6 | ID5 | 32 | |
| 1352 | − 7 | ID6 | 64 | |
| 1353 | − 8 | ID7 | 128 | |
| 1354 | − | |
| 1355 | −Some Examples: | |
| 1356 | − | |
| 1357 | − Switch | Hex | Decimal | |
| 1384 | + ======= ====== ===== | |
| 1385 | + Switch Label Value | |
| 1386 | + ======= ====== ===== | |
| 1387 | + 1 ID0 1 | |
| 1388 | + 2 ID1 2 | |
| 1389 | + 3 ID2 4 | |
| 1390 | + 4 ID3 8 | |
| 1391 | + 5 ID4 16 | |
| 1392 | + 6 ID5 32 | |
| 1393 | + 7 ID6 64 | |
| 1394 | + 8 ID7 128 | |
| 1395 | + ======= ====== ===== | |
| 1396 | + | |
| 1397 | +Some Examples:: | |
| 1398 | + | |
| 1399 | + Switch | Hex | Decimal | |
| 1358 | 1400 | 8 7 6 5 4 3 2 1 | Node ID | Node ID |
| 1359 | 1401 | ----------------|---------|--------- |
| 1360 | 1402 | 0 0 0 0 0 0 0 0 | not allowed |
| 1361 | − 0 0 0 0 0 0 0 1 | 1 | 1 | |
| 1403 | + 0 0 0 0 0 0 0 1 | 1 | 1 | |
| 1362 | 1404 | 0 0 0 0 0 0 1 0 | 2 | 2 |
| 1363 | 1405 | 0 0 0 0 0 0 1 1 | 3 | 3 |
| 1364 | 1406 | . . . | | |
| 1365 | 1407 | 0 1 0 1 0 1 0 1 | 55 | 85 |
| 1366 | 1408 | . . . | | |
| 1367 | 1409 | 1 0 1 0 1 0 1 0 | AA | 170 |
| 1368 | − . . . | | | |
| 1410 | + . . . | | | |
| 1369 | 1411 | 1 1 1 1 1 1 0 1 | FD | 253 |
| 1370 | 1412 | 1 1 1 1 1 1 1 0 | FE | 254 |
| 1371 | 1413 | 1 1 1 1 1 1 1 1 | FF | 255 |
| 1372 | 1414 | |
| 1373 | 1415 | |
| 1374 | 1416 | Setting the I/O Base Address |
| 1375 | −---------------------------- | |
| 1417 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 1376 | 1418 | |
| 1377 | 1419 | The last three switches in switch block SW1 are used to select one |
| 1378 | −of eight possible I/O Base addresses using the following table | |
| 1420 | +of eight possible I/O Base addresses using the following table:: | |
| 1379 | 1421 | |
| 1380 | 1422 | |
| 1381 | 1423 | Switch | Hex I/O |
| @@ -1392,13 +1434,15 @@ of eight possible I/O Base addresses using the following table · 10 unmodified lines | ||
| 1392 | 1434 | |
| 1393 | 1435 | |
| 1394 | 1436 | Setting the Base Memory (RAM) buffer Address |
| 1395 | −-------------------------------------------- | |
| 1437 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 1396 | 1438 | |
| 1397 | −The memory buffer (RAM) requires 2K. The base of this buffer can be | |
| 1439 | +The memory buffer (RAM) requires 2K. The base of this buffer can be | |
| 1398 | 1440 | located in any of eight positions. The address of the Boot Prom is |
| 1399 | 1441 | memory base + 8K or memory base + 0x2000. |
| 1400 | 1442 | Switches 1-5 of switch block SW1 select the Memory Base address. |
| 1401 | 1443 | |
| 1444 | +:: | |
| 1445 | + | |
| 1402 | 1446 | Switch | Hex RAM | Hex ROM |
| 1403 | 1447 | 1 2 3 4 5 | Address | Address *) |
| 1404 | 1448 | --------------------|---------|----------- |
| @@ -1410,22 +1454,24 @@ Switches 1-5 of switch block SW1 select the Memory Base address. · 5 unmodified lines | ||
| 1410 | 1454 | ON ON OFF ON OFF | D8000 | DA000 |
| 1411 | 1455 | ON ON ON OFF OFF | DC000 | DE000 |
| 1412 | 1456 | ON ON OFF OFF OFF | E0000 | E2000 |
| 1413 | − | |
| 1414 | −*) To enable the Boot ROM install the jumper JP1 | |
| 1415 | 1457 | |
| 1416 | −Note: Since the switches 1 and 2 are always set to ON it may be possible | |
| 1458 | + *) To enable the Boot ROM install the jumper JP1 | |
| 1459 | + | |
| 1460 | +.. note:: | |
| 1461 | + | |
| 1462 | + Since the switches 1 and 2 are always set to ON it may be possible | |
| 1417 | 1463 | that they can be used to add an offset of 2K, 4K or 6K to the base |
| 1418 | 1464 | address, but this feature is not documented in the manual and I |
| 1419 | 1465 | haven't tested it yet. |
| 1420 | 1466 | |
| 1421 | 1467 | |
| 1422 | 1468 | Setting the Interrupt Line |
| 1423 | −-------------------------- | |
| 1469 | +^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 1424 | 1470 | |
| 1425 | 1471 | To select a hardware interrupt level install one (only one!) of the jumpers |
| 1426 | −JP2, JP3, JP4, JP5, JP6. JP2 is the default. | |
| 1472 | +JP2, JP3, JP4, JP5, JP6. JP2 is the default:: | |
| 1427 | 1473 | |
| 1428 | − Jumper | IRQ | |
| 1474 | + Jumper | IRQ | |
| 1429 | 1475 | -------|----- |
| 1430 | 1476 | 2 | 2 |
| 1431 | 1477 | 3 | 3 |
| @@ -1435,71 +1481,66 @@ JP2, JP3, JP4, JP5, JP6. JP2 is the default. · 3 unmodified lines | ||
| 1435 | 1481 | |
| 1436 | 1482 | |
| 1437 | 1483 | Setting the Internal Terminator on CN120AB/TP/SBT |
| 1438 | −-------------------------------------------------- | |
| 1484 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 1439 | 1485 | |
| 1440 | −The jumper JP12 is used to enable the internal terminator. | |
| 1486 | +The jumper JP12 is used to enable the internal terminator:: | |
| 1441 | 1487 | |
| 1442 | − ----- | |
| 1443 | − 0 | 0 | | |
| 1488 | + ----- | |
| 1489 | + 0 | 0 | | |
| 1444 | 1490 | ----- ON | | ON |
| 1445 | 1491 | | 0 | | 0 | |
| 1446 | 1492 | | | OFF ----- OFF |
| 1447 | 1493 | | 0 | 0 |
| 1448 | 1494 | ----- |
| 1449 | − Terminator Terminator | |
| 1495 | + Terminator Terminator | |
| 1450 | 1496 | disabled enabled |
| 1451 | − | |
| 1497 | + | |
| 1452 | 1498 | |
| 1453 | 1499 | Selecting the Connector Type on CN120ST/SBT |
| 1454 | −------------------------------------------- | |
| 1500 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 1501 | + | |
| 1502 | +:: | |
| 1455 | 1503 | |
| 1456 | 1504 | JP10 JP11 JP10 JP11 |
| 1457 | − ----- ----- | |
| 1458 | − 0 0 | 0 | | 0 | | |
| 1505 | + ----- ----- | |
| 1506 | + 0 0 | 0 | | 0 | | |
| 1459 | 1507 | ----- ----- | | | | |
| 1460 | 1508 | | 0 | | 0 | | 0 | | 0 | |
| 1461 | 1509 | | | | | ----- ----- |
| 1462 | − | 0 | | 0 | 0 0 | |
| 1510 | + | 0 | | 0 | 0 0 | |
| 1463 | 1511 | ----- ----- |
| 1464 | − Coaxial Cable Twisted Pair Cable | |
| 1512 | + Coaxial Cable Twisted Pair Cable | |
| 1465 | 1513 | (Default) |
| 1466 | 1514 | |
| 1467 | 1515 | |
| 1468 | 1516 | Setting the Timeout Parameters |
| 1469 | −------------------------------ | |
| 1517 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 1470 | 1518 | |
| 1471 | −The jumpers labeled EXT1 and EXT2 are used to determine the timeout | |
| 1519 | +The jumpers labeled EXT1 and EXT2 are used to determine the timeout | |
| 1472 | 1520 | parameters. These two jumpers are normally left open. |
| 1473 | 1521 | |
| 1474 | 1522 | |
| 1523 | +CNet Technology Inc. (16-bit cards) | |
| 1524 | +=================================== | |
| 1475 | 1525 | |
| 1476 | −***************************************************************************** | |
| 1477 | − | |
| 1478 | −** CNet Technology Inc. ** | |
| 1479 | 1526 | 160 Series (16-bit cards) |
| 1480 | 1527 | ------------------------- |
| 1481 | 1528 | - from Juergen Seifert <seifert@htwm.de> |
| 1482 | 1529 | |
| 1483 | −CNET TECHNOLOGY INC. (CNet) ARCNET 160A SERIES | |
| 1484 | −============================================== | |
| 1485 | − | |
| 1486 | 1530 | This description has been written by Juergen Seifert <seifert@htwm.de> |
| 1487 | −using information from the following Original CNet Manual | |
| 1531 | +using information from the following Original CNet Manual | |
| 1488 | 1532 | |
| 1489 | − "ARCNET | |
| 1490 | − USER'S MANUAL | |
| 1491 | − for | |
| 1492 | − CN160A | |
| 1493 | − CN160AB | |
| 1494 | − CN160TP | |
| 1495 | − P/N:12-01-0006 | |
| 1496 | − Revision 3.00" | |
| 1533 | + "ARCNET USER'S MANUAL for | |
| 1534 | + CN160A CN160AB CN160TP | |
| 1535 | + P/N:12-01-0006 Revision 3.00" | |
| 1497 | 1536 | |
| 1498 | 1537 | ARCNET is a registered trademark of the Datapoint Corporation |
| 1499 | 1538 | |
| 1500 | −P/N 160A ARCNET 16 bit XT/AT Star | |
| 1501 | −P/N 160AB ARCNET 16 bit XT/AT Bus | |
| 1502 | −P/N 160TP ARCNET 16 bit XT/AT Twisted Pair | |
| 1539 | +- P/N 160A ARCNET 16 bit XT/AT Star | |
| 1540 | +- P/N 160AB ARCNET 16 bit XT/AT Bus | |
| 1541 | +- P/N 160TP ARCNET 16 bit XT/AT Twisted Pair | |
| 1542 | + | |
| 1543 | +:: | |
| 1503 | 1544 | |
| 1504 | 1545 | ___________________________________________________________________ |
| 1505 | 1546 | < _________________________ ___| |
| @@ -1526,30 +1567,30 @@ P/N 160TP ARCNET 16 bit XT/AT Twisted Pair · 20 unmodified lines | ||
| 1526 | 1567 | > | | | |
| 1527 | 1568 | <____________| |_______________________________________| |
| 1528 | 1569 | |
| 1529 | −Legend: | |
| 1570 | +Legend:: | |
| 1530 | 1571 | |
| 1531 | −9026 ARCNET Probe | |
| 1532 | −SW1 1-6: Base I/O Address Select | |
| 1533 | − 7-10: Base Memory Address Select | |
| 1534 | −SW2 1-8: Node ID Select (ID0-ID7) | |
| 1535 | −JP1/JP2 ET1, ET2 Timeout Parameters | |
| 1536 | −JP3-JP13 Interrupt Select | |
| 1537 | −J1 BNC RG62/U Connector (CN160A/AB only) | |
| 1538 | −J1 Two 6-position Telephone Jack (CN160TP only) | |
| 1539 | −LED | |
| 1572 | + 9026 ARCNET Probe | |
| 1573 | + SW1 1-6: Base I/O Address Select | |
| 1574 | + 7-10: Base Memory Address Select | |
| 1575 | + SW2 1-8: Node ID Select (ID0-ID7) | |
| 1576 | + JP1/JP2 ET1, ET2 Timeout Parameters | |
| 1577 | + JP3-JP13 Interrupt Select | |
| 1578 | + J1 BNC RG62/U Connector (CN160A/AB only) | |
| 1579 | + J1 Two 6-position Telephone Jack (CN160TP only) | |
| 1580 | + LED | |
| 1540 | 1581 | |
| 1541 | 1582 | Setting one of the switches to Off means "1", On means "0". |
| 1542 | 1583 | |
| 1543 | 1584 | |
| 1544 | 1585 | Setting the Node ID |
| 1545 | −------------------- | |
| 1586 | +^^^^^^^^^^^^^^^^^^^ | |
| 1546 | 1587 | |
| 1547 | 1588 | The eight switches in SW2 are used to set the node ID. Each node attached |
| 1548 | 1589 | to the network must have an unique node ID which must be different from 0. |
| 1549 | 1590 | Switch 1 (ID0) serves as the least significant bit (LSB). |
| 1550 | 1591 | |
| 1551 | −The node ID is the sum of the values of all switches set to "1" | |
| 1552 | −These values are: | |
| 1592 | +The node ID is the sum of the values of all switches set to "1" | |
| 1593 | +These values are:: | |
| 1553 | 1594 | |
| 1554 | 1595 | Switch | Label | Value |
| 1555 | 1596 | -------|-------|------- |
| @@ -1562,32 +1603,32 @@ These values are: · 6 unmodified lines | ||
| 1562 | 1603 | 7 | ID6 | 64 |
| 1563 | 1604 | 8 | ID7 | 128 |
| 1564 | 1605 | |
| 1565 | −Some Examples: | |
| 1606 | +Some Examples:: | |
| 1566 | 1607 | |
| 1567 | − Switch | Hex | Decimal | |
| 1608 | + Switch | Hex | Decimal | |
| 1568 | 1609 | 8 7 6 5 4 3 2 1 | Node ID | Node ID |
| 1569 | 1610 | ----------------|---------|--------- |
| 1570 | 1611 | 0 0 0 0 0 0 0 0 | not allowed |
| 1571 | − 0 0 0 0 0 0 0 1 | 1 | 1 | |
| 1612 | + 0 0 0 0 0 0 0 1 | 1 | 1 | |
| 1572 | 1613 | 0 0 0 0 0 0 1 0 | 2 | 2 |
| 1573 | 1614 | 0 0 0 0 0 0 1 1 | 3 | 3 |
| 1574 | 1615 | . . . | | |
| 1575 | 1616 | 0 1 0 1 0 1 0 1 | 55 | 85 |
| 1576 | 1617 | . . . | | |
| 1577 | 1618 | 1 0 1 0 1 0 1 0 | AA | 170 |
| 1578 | − . . . | | | |
| 1619 | + . . . | | | |
| 1579 | 1620 | 1 1 1 1 1 1 0 1 | FD | 253 |
| 1580 | 1621 | 1 1 1 1 1 1 1 0 | FE | 254 |
| 1581 | 1622 | 1 1 1 1 1 1 1 1 | FF | 255 |
| 1582 | 1623 | |
| 1583 | 1624 | |
| 1584 | 1625 | Setting the I/O Base Address |
| 1585 | −---------------------------- | |
| 1626 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 1586 | 1627 | |
| 1587 | 1628 | The first six switches in switch block SW1 are used to select the I/O Base |
| 1588 | −address using the following table: | |
| 1629 | +address using the following table:: | |
| 1589 | 1630 | |
| 1590 | − Switch | Hex I/O | |
| 1631 | + Switch | Hex I/O | |
| 1591 | 1632 | 1 2 3 4 5 6 | Address |
| 1592 | 1633 | ------------------------|-------- |
| 1593 | 1634 | OFF ON ON OFF OFF ON | 260 |
| @@ -1604,10 +1645,10 @@ Note: Other IO-Base addresses seem to be selectable, but only the above · 10 unmodified lines | ||
| 1604 | 1645 | |
| 1605 | 1646 | |
| 1606 | 1647 | Setting the Base Memory (RAM) buffer Address |
| 1607 | −-------------------------------------------- | |
| 1648 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 1608 | 1649 | |
| 1609 | 1650 | The switches 7-10 of switch block SW1 are used to select the Memory |
| 1610 | −Base address of the RAM (2K) and the PROM. | |
| 1651 | +Base address of the RAM (2K) and the PROM:: | |
| 1611 | 1652 | |
| 1612 | 1653 | Switch | Hex RAM | Hex ROM |
| 1613 | 1654 | 7 8 9 10 | Address | Address |
| @@ -1616,17 +1657,19 @@ Base address of the RAM (2K) and the PROM. · 2 unmodified lines | ||
| 1616 | 1657 | OFF OFF ON OFF | D0000 | D8000 (Default) |
| 1617 | 1658 | OFF OFF OFF ON | E0000 | E8000 |
| 1618 | 1659 | |
| 1619 | −Note: Other MEM-Base addresses seem to be selectable, but only the above | |
| 1660 | +.. note:: | |
| 1661 | + | |
| 1662 | + Other MEM-Base addresses seem to be selectable, but only the above | |
| 1620 | 1663 | combinations are documented. |
| 1621 | 1664 | |
| 1622 | 1665 | |
| 1623 | 1666 | Setting the Interrupt Line |
| 1624 | −-------------------------- | |
| 1667 | +^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 1625 | 1668 | |
| 1626 | 1669 | To select a hardware interrupt level install one (only one!) of the jumpers |
| 1627 | −JP3 through JP13 using the following table: | |
| 1670 | +JP3 through JP13 using the following table:: | |
| 1628 | 1671 | |
| 1629 | − Jumper | IRQ | |
| 1672 | + Jumper | IRQ | |
| 1630 | 1673 | -------|----------------- |
| 1631 | 1674 | 3 | 14 |
| 1632 | 1675 | 4 | 15 |
| @@ -1640,10 +1683,12 @@ JP3 through JP13 using the following table: · 7 unmodified lines | ||
| 1640 | 1683 | 12 | 7 |
| 1641 | 1684 | 13 | 2 (=9) Default! |
| 1642 | 1685 | |
| 1643 | −Note: - Do not use JP11=IRQ6, it may conflict with your Floppy Disk | |
| 1644 | − Controller | |
| 1686 | +.. note:: | |
| 1687 | + | |
| 1688 | + - Do not use JP11=IRQ6, it may conflict with your Floppy Disk | |
| 1689 | + Controller | |
| 1645 | 1690 | - Use JP3=IRQ14 only, if you don't have an IDE-, MFM-, or RLL- |
| 1646 | − Hard Disk, it may conflict with their controllers | |
| 1691 | + Hard Disk, it may conflict with their controllers | |
| 1647 | 1692 | |
| 1648 | 1693 | |
| 1649 | 1694 | Setting the Timeout Parameters |
| @@ -1653,14 +1698,16 @@ The jumpers labeled JP1 and JP2 are used to determine the timeout · 3 unmodified lines | ||
| 1653 | 1698 | parameters. These two jumpers are normally left open. |
| 1654 | 1699 | |
| 1655 | 1700 | |
| 1656 | −***************************************************************************** | |
| 1701 | +Lantech | |
| 1702 | +======= | |
| 1657 | 1703 | |
| 1658 | −** Lantech ** | |
| 1659 | 1704 | 8-bit card, unknown model |
| 1660 | 1705 | ------------------------- |
| 1661 | 1706 | - from Vlad Lungu <vlungu@ugal.ro> - his e-mail address seemed broken at |
| 1662 | 1707 | the time I tried to reach him. Sorry Vlad, if you didn't get my reply. |
| 1663 | 1708 | |
| 1709 | +:: | |
| 1710 | + | |
| 1664 | 1711 | ________________________________________________________________ |
| 1665 | 1712 | | 1 8 | |
| 1666 | 1713 | | ___________ __| |
| @@ -1683,25 +1730,27 @@ parameters. These two jumpers are normally left open. · 16 unmodified lines | ||
| 1683 | 1730 | | | PROM | |ooooo| JP6 | |
| 1684 | 1731 | | |____________| |ooooo| | |
| 1685 | 1732 | |_____________ _ _| |
| 1686 | − |____________________________________________| |__| | |
| 1733 | + |____________________________________________| |__| | |
| 1687 | 1734 | |
| 1688 | 1735 | |
| 1689 | 1736 | UM9065L : ARCnet Controller |
| 1690 | 1737 | |
| 1691 | 1738 | SW 1 : Shared Memory Address and I/O Base |
| 1692 | 1739 | |
| 1693 | − ON=0 | |
| 1740 | +:: | |
| 1694 | 1741 | |
| 1695 | − 12345|Memory Address | |
| 1696 | − -----|-------------- | |
| 1697 | − 00001| D4000 | |
| 1698 | − 00010| CC000 | |
| 1699 | − 00110| D0000 | |
| 1700 | − 01110| D1000 | |
| 1701 | − 01101| D9000 | |
| 1702 | − 10010| CC800 | |
| 1703 | − 10011| DC800 | |
| 1704 | − 11110| D1800 | |
| 1742 | + ON=0 | |
| 1743 | + | |
| 1744 | + 12345|Memory Address | |
| 1745 | + -----|-------------- | |
| 1746 | + 00001| D4000 | |
| 1747 | + 00010| CC000 | |
| 1748 | + 00110| D0000 | |
| 1749 | + 01110| D1000 | |
| 1750 | + 01101| D9000 | |
| 1751 | + 10010| CC800 | |
| 1752 | + 10011| DC800 | |
| 1753 | + 11110| D1800 | |
| 1705 | 1754 | |
| 1706 | 1755 | It seems that the bits are considered in reverse order. Also, you must |
| 1707 | 1756 | observe that some of those addresses are unusual and I didn't probe them; I |
| @@ -1710,43 +1759,48 @@ some others that I didn't write here the card seems to conflict with the · 2 unmodified lines | ||
| 1710 | 1759 | video card (an S3 GENDAC). I leave the full decoding of those addresses to |
| 1711 | 1760 | you. |
| 1712 | 1761 | |
| 1713 | − 678| I/O Address | |
| 1714 | − ---|------------ | |
| 1715 | − 000| 260 | |
| 1716 | − 001| failed probe | |
| 1717 | − 010| 2E0 | |
| 1718 | − 011| 380 | |
| 1719 | − 100| 290 | |
| 1720 | − 101| 350 | |
| 1721 | − 110| failed probe | |
| 1722 | − 111| 3E0 | |
| 1762 | +:: | |
| 1723 | 1763 | |
| 1724 | −SW 2 : Node ID (binary coded) | |
| 1764 | + 678| I/O Address | |
| 1765 | + ---|------------ | |
| 1766 | + 000| 260 | |
| 1767 | + 001| failed probe | |
| 1768 | + 010| 2E0 | |
| 1769 | + 011| 380 | |
| 1770 | + 100| 290 | |
| 1771 | + 101| 350 | |
| 1772 | + 110| failed probe | |
| 1773 | + 111| 3E0 | |
| 1725 | 1774 | |
| 1726 | −JP 4 : Boot PROM enable CLOSE - enabled | |
| 1727 | − OPEN - disabled | |
| 1775 | + SW 2 : Node ID (binary coded) | |
| 1728 | 1776 | |
| 1729 | −JP 6 : IRQ set (ONLY ONE jumper on 1-5 for IRQ 2-6) | |
| 1777 | + JP 4 : Boot PROM enable CLOSE - enabled | |
| 1778 | + OPEN - disabled | |
| 1730 | 1779 | |
| 1780 | + JP 6 : IRQ set (ONLY ONE jumper on 1-5 for IRQ 2-6) | |
| 1731 | 1781 | |
| 1732 | −***************************************************************************** | |
| 1733 | 1782 | |
| 1734 | −** Acer ** | |
| 1783 | +Acer | |
| 1784 | +==== | |
| 1785 | + | |
| 1735 | 1786 | 8-bit card, Model 5210-003 |
| 1736 | 1787 | -------------------------- |
| 1788 | + | |
| 1737 | 1789 | - from Vojtech Pavlik <vojtech@suse.cz> using portions of the existing |
| 1738 | 1790 | arcnet-hardware file. |
| 1739 | 1791 | |
| 1740 | 1792 | This is a 90C26 based card. Its configuration seems similar to the SMC |
| 1741 | 1793 | PC100, but has some additional jumpers I don't know the meaning of. |
| 1742 | 1794 | |
| 1743 | − __ | |
| 1744 | − | | | |
| 1795 | +:: | |
| 1796 | + | |
| 1797 | + __ | |
| 1798 | + | | | |
| 1745 | 1799 | ___________|__|_________________________ |
| 1746 | 1800 | | | | | |
| 1747 | 1801 | | | BNC | | |
| 1748 | 1802 | | |______| ___| |
| 1749 | − | _____________________ |___ | |
| 1803 | + | _____________________ |___ | |
| 1750 | 1804 | | | | | |
| 1751 | 1805 | | | Hybrid IC | | |
| 1752 | 1806 | | | | o|o J1 | |
| @@ -1762,51 +1816,51 @@ PC100, but has some additional jumpers I don't know the meaning of. · 9 unmodified lines | ||
| 1762 | 1816 | | _____ | |
| 1763 | 1817 | | | | _____ | |
| 1764 | 1818 | | | | | | ___| |
| 1765 | − | | | | | | | |
| 1766 | − | _____ | ROM | | UFS | | | |
| 1767 | − | | | | | | | | | |
| 1768 | − | | | ___ | | | | | | |
| 1769 | − | | | | | |__.__| |__.__| | | |
| 1770 | − | | NCR | |XTL| _____ _____ | | |
| 1771 | − | | | |___| | | | | | | |
| 1772 | − | |90C26| | | | | | | |
| 1773 | − | | | | RAM | | UFS | | | |
| 1774 | − | | | J17 o|o | | | | | | |
| 1775 | − | | | J16 o|o | | | | | | |
| 1776 | − | |__.__| |__.__| |__.__| | | |
| 1777 | − | ___ | | |
| 1778 | − | | |8 | | |
| 1779 | − | |SW2| | | |
| 1780 | − | | | | | |
| 1781 | − | |___|1 | | |
| 1782 | − | ___ | | |
| 1783 | − | | |10 J18 o|o | | |
| 1784 | − | | | o|o | | |
| 1785 | − | |SW1| o|o | | |
| 1786 | − | | | J21 o|o | | |
| 1787 | − | |___|1 | | |
| 1788 | − | | | |
| 1789 | − |____________________________________| | |
| 1790 | − | |
| 1791 | − | |
| 1792 | −Legend: | |
| 1793 | − | |
| 1794 | −90C26 ARCNET Chip | |
| 1795 | −XTL 20 MHz Crystal | |
| 1796 | −SW1 1-6 Base I/O Address Select | |
| 1797 | − 7-10 Memory Address Select | |
| 1798 | −SW2 1-8 Node ID Select (ID0-ID7) | |
| 1799 | −J1-J5 IRQ Select | |
| 1800 | −J6-J21 Unknown (Probably extra timeouts & ROM enable ...) | |
| 1801 | −LED1 Activity LED | |
| 1802 | −BNC Coax connector (STAR ARCnet) | |
| 1803 | −RAM 2k of SRAM | |
| 1804 | −ROM Boot ROM socket | |
| 1805 | −UFS Unidentified Flying Sockets | |
| 1819 | + | | | | | | | |
| 1820 | + | _____ | ROM | | UFS | | | |
| 1821 | + | | | | | | | | | |
| 1822 | + | | | ___ | | | | | | |
| 1823 | + | | | | | |__.__| |__.__| | | |
| 1824 | + | | NCR | |XTL| _____ _____ | | |
| 1825 | + | | | |___| | | | | | | |
| 1826 | + | |90C26| | | | | | | |
| 1827 | + | | | | RAM | | UFS | | | |
| 1828 | + | | | J17 o|o | | | | | | |
| 1829 | + | | | J16 o|o | | | | | | |
| 1830 | + | |__.__| |__.__| |__.__| | | |
| 1831 | + | ___ | | |
| 1832 | + | | |8 | | |
| 1833 | + | |SW2| | | |
| 1834 | + | | | | | |
| 1835 | + | |___|1 | | |
| 1836 | + | ___ | | |
| 1837 | + | | |10 J18 o|o | | |
| 1838 | + | | | o|o | | |
| 1839 | + | |SW1| o|o | | |
| 1840 | + | | | J21 o|o | | |
| 1841 | + | |___|1 | | |
| 1842 | + | | | |
| 1843 | + |____________________________________| | |
| 1844 | + | |
| 1845 | + | |
| 1846 | +Legend:: | |
| 1847 | + | |
| 1848 | + 90C26 ARCNET Chip | |
| 1849 | + XTL 20 MHz Crystal | |
| 1850 | + SW1 1-6 Base I/O Address Select | |
| 1851 | + 7-10 Memory Address Select | |
| 1852 | + SW2 1-8 Node ID Select (ID0-ID7) | |
| 1853 | + J1-J5 IRQ Select | |
| 1854 | + J6-J21 Unknown (Probably extra timeouts & ROM enable ...) | |
| 1855 | + LED1 Activity LED | |
| 1856 | + BNC Coax connector (STAR ARCnet) | |
| 1857 | + RAM 2k of SRAM | |
| 1858 | + ROM Boot ROM socket | |
| 1859 | + UFS Unidentified Flying Sockets | |
| 1806 | 1860 | |
| 1807 | 1861 | |
| 1808 | 1862 | Setting the Node ID |
| 1809 | −------------------- | |
| 1863 | +^^^^^^^^^^^^^^^^^^^ | |
| 1810 | 1864 | |
| 1811 | 1865 | The eight switches in SW2 are used to set the node ID. Each node attached |
| 1812 | 1866 | to the network must have an unique node ID which must not be 0. |
| @@ -1815,7 +1869,7 @@ Switch 1 (ID0) serves as the least significant bit (LSB). · 2 unmodified lines | ||
| 1815 | 1869 | Setting one of the switches to OFF means "1", ON means "0". |
| 1816 | 1870 | |
| 1817 | 1871 | The node ID is the sum of the values of all switches set to "1" |
| 1818 | −These values are: | |
| 1872 | +These values are:: | |
| 1819 | 1873 | |
| 1820 | 1874 | Switch | Value |
| 1821 | 1875 | -------|------- |
| @@ -1832,40 +1886,40 @@ Don't set this to 0 or 255; these values are reserved. · 10 unmodified lines | ||
| 1832 | 1886 | |
| 1833 | 1887 | |
| 1834 | 1888 | Setting the I/O Base Address |
| 1835 | −---------------------------- | |
| 1889 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 1836 | 1890 | |
| 1837 | 1891 | The switches 1 to 6 of switch block SW1 are used to select one |
| 1838 | −of 32 possible I/O Base addresses using the following tables | |
| 1839 | − | |
| 1840 | − | Hex | |
| 1892 | +of 32 possible I/O Base addresses using the following tables:: | |
| 1893 | + | |
| 1894 | + | Hex | |
| 1841 | 1895 | Switch | Value |
| 1842 | 1896 | -------|------- |
| 1843 | − 1 | 200 | |
| 1844 | − 2 | 100 | |
| 1845 | − 3 | 80 | |
| 1846 | − 4 | 40 | |
| 1847 | − 5 | 20 | |
| 1848 | − 6 | 10 | |
| 1897 | + 1 | 200 | |
| 1898 | + 2 | 100 | |
| 1899 | + 3 | 80 | |
| 1900 | + 4 | 40 | |
| 1901 | + 5 | 20 | |
| 1902 | + 6 | 10 | |
| 1849 | 1903 | |
| 1850 | 1904 | The I/O address is sum of all switches set to "1". Remember that |
| 1851 | 1905 | the I/O address space bellow 0x200 is RESERVED for mainboard, so |
| 1852 | −switch 1 should be ALWAYS SET TO OFF. | |
| 1906 | +switch 1 should be ALWAYS SET TO OFF. | |
| 1853 | 1907 | |
| 1854 | 1908 | |
| 1855 | 1909 | Setting the Base Memory (RAM) buffer Address |
| 1856 | −-------------------------------------------- | |
| 1910 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 1857 | 1911 | |
| 1858 | 1912 | The memory buffer (RAM) requires 2K. The base of this buffer can be |
| 1859 | 1913 | located in any of sixteen positions. However, the addresses below |
| 1860 | 1914 | A0000 are likely to cause system hang because there's main RAM. |
| 1861 | 1915 | |
| 1862 | −Jumpers 7-10 of switch block SW1 select the Memory Base address. | |
| 1916 | +Jumpers 7-10 of switch block SW1 select the Memory Base address:: | |
| 1863 | 1917 | |
| 1864 | 1918 | Switch | Hex RAM |
| 1865 | 1919 | 7 8 9 10 | Address |
| 1866 | 1920 | ----------------|--------- |
| 1867 | 1921 | OFF OFF OFF OFF | F0000 (conflicts with main BIOS) |
| 1868 | − OFF OFF OFF ON | E0000 | |
| 1922 | + OFF OFF OFF ON | E0000 | |
| 1869 | 1923 | OFF OFF ON OFF | D0000 |
| 1870 | 1924 | OFF OFF ON ON | C0000 (conflicts with video BIOS) |
| 1871 | 1925 | OFF ON OFF OFF | B0000 (conflicts with mono video) |
| @@ -1873,10 +1927,10 @@ Jumpers 7-10 of switch block SW1 select the Memory Base address. · 1 unmodified line | ||
| 1873 | 1927 | |
| 1874 | 1928 | |
| 1875 | 1929 | Setting the Interrupt Line |
| 1876 | −-------------------------- | |
| 1930 | +^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 1877 | 1931 | |
| 1878 | −Jumpers 1-5 of the jumper block J1 control the IRQ level. ON means | |
| 1879 | −shorted, OFF means open. | |
| 1932 | +Jumpers 1-5 of the jumper block J1 control the IRQ level. ON means | |
| 1933 | +shorted, OFF means open:: | |
| 1880 | 1934 | |
| 1881 | 1935 | Jumper | IRQ |
| 1882 | 1936 | 1 2 3 4 5 | |
| @@ -1889,65 +1943,67 @@ shorted, OFF means open. · 6 unmodified lines | ||
| 1889 | 1943 | |
| 1890 | 1944 | |
| 1891 | 1945 | Unknown jumpers & sockets |
| 1892 | −------------------------- | |
| 1946 | +^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 1893 | 1947 | |
| 1894 | 1948 | I know nothing about these. I just guess that J16&J17 are timeout |
| 1895 | 1949 | jumpers and maybe one of J18-J21 selects ROM. Also J6-J10 and |
| 1896 | 1950 | J11-J15 are connecting IRQ2-7 to some pins on the UFSs. I can't |
| 1897 | 1951 | guess the purpose. |
| 1898 | 1952 | |
| 1953 | +Datapoint? | |
| 1954 | +========== | |
| 1899 | 1955 | |
| 1900 | −***************************************************************************** | |
| 1901 | − | |
| 1902 | −** Datapoint? ** | |
| 1903 | 1956 | LAN-ARC-8, an 8-bit card |
| 1904 | 1957 | ------------------------ |
| 1958 | + | |
| 1905 | 1959 | - from Vojtech Pavlik <vojtech@suse.cz> |
| 1906 | 1960 | |
| 1907 | 1961 | This is another SMC 90C65-based ARCnet card. I couldn't identify the |
| 1908 | 1962 | manufacturer, but it might be DataPoint, because the card has the |
| 1909 | 1963 | original arcNet logo in its upper right corner. |
| 1910 | 1964 | |
| 1911 | − _______________________________________________________ | |
| 1912 | − | _________ | | |
| 1913 | − | | SW2 | ON arcNet | | |
| 1914 | − | |_________| OFF ___| | |
| 1915 | − | _____________ 1 ______ 8 | | 8 | |
| 1916 | − | | | SW1 | XTAL | ____________ | S | | |
| 1917 | − | > RAM (2k) | |______|| | | W | | |
| 1918 | − | |_____________| | H | | 3 | | |
| 1919 | − | _________|_____ y | |___| 1 | |
| 1920 | − | _________ | | |b | | | |
| 1921 | − | |_________| | | |r | | | |
| 1922 | − | | SMC | |i | | | |
| 1923 | − | | 90C65| |d | | | |
| 1924 | − | _________ | | | | | | |
| 1925 | − | | SW1 | ON | | |I | | | |
| 1926 | − | |_________| OFF |_________|_____/C | _____| | |
| 1927 | − | 1 8 | | | |___ | |
| 1928 | − | ______________ | | | BNC |___| | |
| 1929 | − | | | |____________| |_____| | |
| 1930 | − | > EPROM SOCKET | _____________ | | |
| 1931 | − | |______________| |_____________| | | |
| 1932 | − | ______________| | |
| 1933 | − | | | |
| 1934 | − |________________________________________| | |
| 1935 | − | |
| 1936 | −Legend: | |
| 1937 | − | |
| 1938 | −90C65 ARCNET Chip | |
| 1939 | −SW1 1-5: Base Memory Address Select | |
| 1940 | − 6-8: Base I/O Address Select | |
| 1941 | −SW2 1-8: Node ID Select | |
| 1942 | −SW3 1-5: IRQ Select | |
| 1943 | − 6-7: Extra Timeout | |
| 1944 | − 8 : ROM Enable | |
| 1945 | −BNC Coax connector | |
| 1946 | −XTAL 20 MHz Crystal | |
| 1965 | +:: | |
| 1966 | + | |
| 1967 | + _______________________________________________________ | |
| 1968 | + | _________ | | |
| 1969 | + | | SW2 | ON arcNet | | |
| 1970 | + | |_________| OFF ___| | |
| 1971 | + | _____________ 1 ______ 8 | | 8 | |
| 1972 | + | | | SW1 | XTAL | ____________ | S | | |
| 1973 | + | > RAM (2k) | |______|| | | W | | |
| 1974 | + | |_____________| | H | | 3 | | |
| 1975 | + | _________|_____ y | |___| 1 | |
| 1976 | + | _________ | | |b | | | |
| 1977 | + | |_________| | | |r | | | |
| 1978 | + | | SMC | |i | | | |
| 1979 | + | | 90C65| |d | | | |
| 1980 | + | _________ | | | | | | |
| 1981 | + | | SW1 | ON | | |I | | | |
| 1982 | + | |_________| OFF |_________|_____/C | _____| | |
| 1983 | + | 1 8 | | | |___ | |
| 1984 | + | ______________ | | | BNC |___| | |
| 1985 | + | | | |____________| |_____| | |
| 1986 | + | > EPROM SOCKET | _____________ | | |
| 1987 | + | |______________| |_____________| | | |
| 1988 | + | ______________| | |
| 1989 | + | | | |
| 1990 | + |________________________________________| | |
| 1991 | + | |
| 1992 | +Legend:: | |
| 1993 | + | |
| 1994 | + 90C65 ARCNET Chip | |
| 1995 | + SW1 1-5: Base Memory Address Select | |
| 1996 | + 6-8: Base I/O Address Select | |
| 1997 | + SW2 1-8: Node ID Select | |
| 1998 | + SW3 1-5: IRQ Select | |
| 1999 | + 6-7: Extra Timeout | |
| 2000 | + 8 : ROM Enable | |
| 2001 | + BNC Coax connector | |
| 2002 | + XTAL 20 MHz Crystal | |
| 1947 | 2003 | |
| 1948 | 2004 | |
| 1949 | 2005 | Setting the Node ID |
| 1950 | −------------------- | |
| 2006 | +^^^^^^^^^^^^^^^^^^^ | |
| 1951 | 2007 | |
| 1952 | 2008 | The eight switches in SW3 are used to set the node ID. Each node attached |
| 1953 | 2009 | to the network must have an unique node ID which must not be 0. |
| @@ -1955,8 +2011,8 @@ Switch 1 serves as the least significant bit (LSB). · 1 unmodified line | ||
| 1955 | 2011 | |
| 1956 | 2012 | Setting one of the switches to Off means "1", On means "0". |
| 1957 | 2013 | |
| 1958 | −The node ID is the sum of the values of all switches set to "1" | |
| 1959 | −These values are: | |
| 2014 | +The node ID is the sum of the values of all switches set to "1" | |
| 2015 | +These values are:: | |
| 1960 | 2016 | |
| 1961 | 2017 | Switch | Value |
| 1962 | 2018 | -------|------- |
| @@ -1971,10 +2027,10 @@ These values are: · 8 unmodified lines | ||
| 1971 | 2027 | |
| 1972 | 2028 | |
| 1973 | 2029 | Setting the I/O Base Address |
| 1974 | −---------------------------- | |
| 2030 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 1975 | 2031 | |
| 1976 | 2032 | The last three switches in switch block SW1 are used to select one |
| 1977 | −of eight possible I/O Base addresses using the following table | |
| 2033 | +of eight possible I/O Base addresses using the following table:: | |
| 1978 | 2034 | |
| 1979 | 2035 | |
| 1980 | 2036 | Switch | Hex I/O |
| @@ -1991,13 +2047,16 @@ of eight possible I/O Base addresses using the following table · 10 unmodified lines | ||
| 1991 | 2047 | |
| 1992 | 2048 | |
| 1993 | 2049 | Setting the Base Memory (RAM) buffer Address |
| 1994 | −-------------------------------------------- | |
| 2050 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 1995 | 2051 | |
| 1996 | −The memory buffer (RAM) requires 2K. The base of this buffer can be | |
| 2052 | +The memory buffer (RAM) requires 2K. The base of this buffer can be | |
| 1997 | 2053 | located in any of eight positions. The address of the Boot Prom is |
| 1998 | 2054 | memory base + 0x2000. |
| 2055 | + | |
| 1999 | 2056 | Jumpers 3-5 of switch block SW1 select the Memory Base address. |
| 2000 | 2057 | |
| 2058 | +:: | |
| 2059 | + | |
| 2001 | 2060 | Switch | Hex RAM | Hex ROM |
| 2002 | 2061 | 1 2 3 4 5 | Address | Address *) |
| 2003 | 2062 | --------------------|---------|----------- |
| @@ -2009,16 +2068,16 @@ Jumpers 3-5 of switch block SW1 select the Memory Base address. · 5 unmodified lines | ||
| 2009 | 2068 | ON ON OFF ON OFF | D8000 | DA000 |
| 2010 | 2069 | ON ON ON OFF OFF | DC000 | DE000 |
| 2011 | 2070 | ON ON OFF OFF OFF | E0000 | E2000 |
| 2012 | − | |
| 2013 | −*) To enable the Boot ROM set the switch 8 of switch block SW3 to position ON. | |
| 2071 | + | |
| 2072 | + *) To enable the Boot ROM set the switch 8 of switch block SW3 to position ON. | |
| 2014 | 2073 | |
| 2015 | 2074 | The switches 1 and 2 probably add 0x0800 and 0x1000 to RAM base address. |
| 2016 | 2075 | |
| 2017 | 2076 | |
| 2018 | 2077 | Setting the Interrupt Line |
| 2019 | −-------------------------- | |
| 2078 | +^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2020 | 2079 | |
| 2021 | −Switches 1-5 of the switch block SW3 control the IRQ level. | |
| 2080 | +Switches 1-5 of the switch block SW3 control the IRQ level:: | |
| 2022 | 2081 | |
| 2023 | 2082 | Jumper | IRQ |
| 2024 | 2083 | 1 2 3 4 5 | |
| @@ -2031,64 +2090,67 @@ Switches 1-5 of the switch block SW3 control the IRQ level. · 6 unmodified lines | ||
| 2031 | 2090 | |
| 2032 | 2091 | |
| 2033 | 2092 | Setting the Timeout Parameters |
| 2034 | −------------------------------ | |
| 2093 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2035 | 2094 | |
| 2036 | 2095 | The switches 6-7 of the switch block SW3 are used to determine the timeout |
| 2037 | 2096 | parameters. These two switches are normally left in the OFF position. |
| 2038 | 2097 | |
| 2039 | 2098 | |
| 2040 | −***************************************************************************** | |
| 2099 | +Topware | |
| 2100 | +======= | |
| 2041 | 2101 | |
| 2042 | −** Topware ** | |
| 2043 | 2102 | 8-bit card, TA-ARC/10 |
| 2044 | −------------------------- | |
| 2103 | +--------------------- | |
| 2104 | + | |
| 2045 | 2105 | - from Vojtech Pavlik <vojtech@suse.cz> |
| 2046 | 2106 | |
| 2047 | 2107 | This is another very similar 90C65 card. Most of the switches and jumpers |
| 2048 | 2108 | are the same as on other clones. |
| 2049 | 2109 | |
| 2050 | − _____________________________________________________________________ | |
| 2051 | −| ___________ | | ______ | | |
| 2052 | −| |SW2 NODE ID| | | | XTAL | | | |
| 2053 | −| |___________| | Hybrid IC | |______| | | |
| 2054 | −| ___________ | | __| | |
| 2055 | −| |SW1 MEM+I/O| |_________________________| LED1|__|) | |
| 2056 | −| |___________| 1 2 | | |
| 2057 | −| J3 |o|o| TIMEOUT ______| | |
| 2058 | −| ______________ |o|o| | | | |
| 2059 | −| | | ___________________ | RJ | | |
| 2060 | −| > EPROM SOCKET | | \ |------| | |
| 2061 | −|J2 |______________| | | | | | |
| 2062 | −||o| | | |______| | |
| 2063 | −||o| ROM ENABLE | SMC | _________ | | |
| 2064 | −| _____________ | 90C65 | |_________| _____| | |
| 2065 | −| | | | | | |___ | |
| 2066 | −| > RAM (2k) | | | | BNC |___| | |
| 2067 | −| |_____________| | | |_____| | |
| 2068 | −| |____________________| | | |
| 2069 | −| ________ IRQ 2 3 4 5 7 ___________ | | |
| 2070 | −||________| |o|o|o|o|o| |___________| | | |
| 2071 | −|________ J1|o|o|o|o|o| ______________| | |
| 2072 | − | | | |
| 2073 | − |_____________________________________________| | |
| 2074 | − | |
| 2075 | −Legend: | |
| 2076 | − | |
| 2077 | −90C65 ARCNET Chip | |
| 2078 | −XTAL 20 MHz Crystal | |
| 2079 | −SW1 1-5 Base Memory Address Select | |
| 2080 | − 6-8 Base I/O Address Select | |
| 2081 | −SW2 1-8 Node ID Select (ID0-ID7) | |
| 2082 | −J1 IRQ Select | |
| 2083 | −J2 ROM Enable | |
| 2084 | −J3 Extra Timeout | |
| 2085 | −LED1 Activity LED | |
| 2086 | −BNC Coax connector (BUS ARCnet) | |
| 2087 | −RJ Twisted Pair Connector (daisy chain) | |
| 2110 | +:: | |
| 2111 | + | |
| 2112 | + _____________________________________________________________________ | |
| 2113 | + | ___________ | | ______ | | |
| 2114 | + | |SW2 NODE ID| | | | XTAL | | | |
| 2115 | + | |___________| | Hybrid IC | |______| | | |
| 2116 | + | ___________ | | __| | |
| 2117 | + | |SW1 MEM+I/O| |_________________________| LED1|__|) | |
| 2118 | + | |___________| 1 2 | | |
| 2119 | + | J3 |o|o| TIMEOUT ______| | |
| 2120 | + | ______________ |o|o| | | | |
| 2121 | + | | | ___________________ | RJ | | |
| 2122 | + | > EPROM SOCKET | | \ |------| | |
| 2123 | + |J2 |______________| | | | | | |
| 2124 | + ||o| | | |______| | |
| 2125 | + ||o| ROM ENABLE | SMC | _________ | | |
| 2126 | + | _____________ | 90C65 | |_________| _____| | |
| 2127 | + | | | | | | |___ | |
| 2128 | + | > RAM (2k) | | | | BNC |___| | |
| 2129 | + | |_____________| | | |_____| | |
| 2130 | + | |____________________| | | |
| 2131 | + | ________ IRQ 2 3 4 5 7 ___________ | | |
| 2132 | + ||________| |o|o|o|o|o| |___________| | | |
| 2133 | + |________ J1|o|o|o|o|o| ______________| | |
| 2134 | + | | | |
| 2135 | + |_____________________________________________| | |
| 2136 | + | |
| 2137 | +Legend:: | |
| 2138 | + | |
| 2139 | + 90C65 ARCNET Chip | |
| 2140 | + XTAL 20 MHz Crystal | |
| 2141 | + SW1 1-5 Base Memory Address Select | |
| 2142 | + 6-8 Base I/O Address Select | |
| 2143 | + SW2 1-8 Node ID Select (ID0-ID7) | |
| 2144 | + J1 IRQ Select | |
| 2145 | + J2 ROM Enable | |
| 2146 | + J3 Extra Timeout | |
| 2147 | + LED1 Activity LED | |
| 2148 | + BNC Coax connector (BUS ARCnet) | |
| 2149 | + RJ Twisted Pair Connector (daisy chain) | |
| 2088 | 2150 | |
| 2089 | 2151 | |
| 2090 | 2152 | Setting the Node ID |
| 2091 | −------------------- | |
| 2153 | +^^^^^^^^^^^^^^^^^^^ | |
| 2092 | 2154 | |
| 2093 | 2155 | The eight switches in SW2 are used to set the node ID. Each node attached to |
| 2094 | 2156 | the network must have an unique node ID which must not be 0. Switch 1 (ID0) |
| @@ -2097,7 +2159,7 @@ serves as the least significant bit (LSB). · 2 unmodified lines | ||
| 2097 | 2159 | Setting one of the switches to Off means "1", On means "0". |
| 2098 | 2160 | |
| 2099 | 2161 | The node ID is the sum of the values of all switches set to "1" |
| 2100 | −These values are: | |
| 2162 | +These values are:: | |
| 2101 | 2163 | |
| 2102 | 2164 | Switch | Label | Value |
| 2103 | 2165 | -------|-------|------- |
| @@ -2111,10 +2173,10 @@ These values are: · 7 unmodified lines | ||
| 2111 | 2173 | 8 | ID7 | 128 |
| 2112 | 2174 | |
| 2113 | 2175 | Setting the I/O Base Address |
| 2114 | −---------------------------- | |
| 2176 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2115 | 2177 | |
| 2116 | 2178 | The last three switches in switch block SW1 are used to select one |
| 2117 | −of eight possible I/O Base addresses using the following table: | |
| 2179 | +of eight possible I/O Base addresses using the following table:: | |
| 2118 | 2180 | |
| 2119 | 2181 | |
| 2120 | 2182 | Switch | Hex I/O |
| @@ -2122,7 +2184,7 @@ of eight possible I/O Base addresses using the following table: · 1 unmodified line | ||
| 2122 | 2184 | ------------|-------- |
| 2123 | 2185 | ON ON ON | 260 (Manufacturer's default) |
| 2124 | 2186 | OFF ON ON | 290 |
| 2125 | − ON OFF ON | 2E0 | |
| 2187 | + ON OFF ON | 2E0 | |
| 2126 | 2188 | OFF OFF ON | 2F0 |
| 2127 | 2189 | ON ON OFF | 300 |
| 2128 | 2190 | OFF ON OFF | 350 |
| @@ -2131,35 +2193,38 @@ of eight possible I/O Base addresses using the following table: · 2 unmodified lines | ||
| 2131 | 2193 | |
| 2132 | 2194 | |
| 2133 | 2195 | Setting the Base Memory (RAM) buffer Address |
| 2134 | −-------------------------------------------- | |
| 2196 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2135 | 2197 | |
| 2136 | 2198 | The memory buffer (RAM) requires 2K. The base of this buffer can be |
| 2137 | 2199 | located in any of eight positions. The address of the Boot Prom is |
| 2138 | 2200 | memory base + 0x2000. |
| 2201 | + | |
| 2139 | 2202 | Jumpers 3-5 of switch block SW1 select the Memory Base address. |
| 2140 | 2203 | |
| 2204 | +:: | |
| 2205 | + | |
| 2141 | 2206 | Switch | Hex RAM | Hex ROM |
| 2142 | 2207 | 1 2 3 4 5 | Address | Address *) |
| 2143 | 2208 | --------------------|---------|----------- |
| 2144 | 2209 | ON ON ON ON ON | C0000 | C2000 |
| 2145 | − ON ON OFF ON ON | C4000 | C6000 (Manufacturer's default) | |
| 2210 | + ON ON OFF ON ON | C4000 | C6000 (Manufacturer's default) | |
| 2146 | 2211 | ON ON ON OFF ON | CC000 | CE000 |
| 2147 | − ON ON OFF OFF ON | D0000 | D2000 | |
| 2212 | + ON ON OFF OFF ON | D0000 | D2000 | |
| 2148 | 2213 | ON ON ON ON OFF | D4000 | D6000 |
| 2149 | 2214 | ON ON OFF ON OFF | D8000 | DA000 |
| 2150 | 2215 | ON ON ON OFF OFF | DC000 | DE000 |
| 2151 | 2216 | ON ON OFF OFF OFF | E0000 | E2000 |
| 2152 | 2217 | |
| 2153 | −*) To enable the Boot ROM short the jumper J2. | |
| 2218 | + *) To enable the Boot ROM short the jumper J2. | |
| 2154 | 2219 | |
| 2155 | 2220 | The jumpers 1 and 2 probably add 0x0800 and 0x1000 to RAM address. |
| 2156 | 2221 | |
| 2157 | 2222 | |
| 2158 | 2223 | Setting the Interrupt Line |
| 2159 | −-------------------------- | |
| 2224 | +^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2160 | 2225 | |
| 2161 | 2226 | Jumpers 1-5 of the jumper block J1 control the IRQ level. ON means |
| 2162 | −shorted, OFF means open. | |
| 2227 | +shorted, OFF means open:: | |
| 2163 | 2228 | |
| 2164 | 2229 | Jumper | IRQ |
| 2165 | 2230 | 1 2 3 4 5 | |
| @@ -2172,19 +2237,21 @@ shorted, OFF means open. · 6 unmodified lines | ||
| 2172 | 2237 | |
| 2173 | 2238 | |
| 2174 | 2239 | Setting the Timeout Parameters |
| 2175 | −------------------------------ | |
| 2240 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2176 | 2241 | |
| 2177 | −The jumpers J3 are used to set the timeout parameters. These two | |
| 2242 | +The jumpers J3 are used to set the timeout parameters. These two | |
| 2178 | 2243 | jumpers are normally left open. |
| 2179 | 2244 | |
| 2180 | − | |
| 2181 | −***************************************************************************** | |
| 2245 | +Thomas-Conrad | |
| 2246 | +============= | |
| 2182 | 2247 | |
| 2183 | −** Thomas-Conrad ** | |
| 2184 | 2248 | Model #500-6242-0097 REV A (8-bit card) |
| 2185 | 2249 | --------------------------------------- |
| 2250 | + | |
| 2186 | 2251 | - from Lars Karlsson <100617.3473@compuserve.com> |
| 2187 | 2252 | |
| 2253 | +:: | |
| 2254 | + | |
| 2188 | 2255 | ________________________________________________________ |
| 2189 | 2256 | | ________ ________ |_____ |
| 2190 | 2257 | | |........| |........| | |
| @@ -2194,11 +2261,11 @@ Model #500-6242-0097 REV A (8-bit card) · 3 unmodified lines | ||
| 2194 | 2261 | | address | | |
| 2195 | 2262 | | ______ switch | | |
| 2196 | 2263 | | | | | | |
| 2197 | − | | | |___| | |
| 2264 | + | | | |___| | |
| 2198 | 2265 | | | | ______ |___._ |
| 2199 | 2266 | | |______| |______| ____| BNC |
| 2200 | 2267 | | Jumper- _____| Connector |
| 2201 | − | Main chip block _ __| ' | |
| 2268 | + | Main chip block _ __| ' | |
| 2202 | 2269 | | | | | RJ Connector |
| 2203 | 2270 | | |_| | with 110 Ohm |
| 2204 | 2271 | | |__ Terminator |
| @@ -2208,46 +2275,49 @@ Model #500-6242-0097 REV A (8-bit card) · 3 unmodified lines | ||
| 2208 | 2275 | | |___________| |_____| |__ |
| 2209 | 2276 | | Boot PROM socket IRQ-jumpers |_ Diagnostic |
| 2210 | 2277 | |________ __ _| LED (red) |
| 2211 | − | | | | | | | | | | | | | | | | | | | | | | | |
| 2212 | − | | | | | | | | | | | | | | | | | | | | |________| | |
| 2213 | − | | |
| 2214 | − | | |
| 2278 | + | | | | | | | | | | | | | | | | | | | | | | | |
| 2279 | + | | | | | | | | | | | | | | | | | | | | |________| | |
| 2280 | + | | |
| 2281 | + | | |
| 2215 | 2282 | |
| 2216 | 2283 | And here are the settings for some of the switches and jumpers on the cards. |
| 2217 | 2284 | |
| 2285 | +:: | |
| 2218 | 2286 | |
| 2219 | − I/O | |
| 2287 | + I/O | |
| 2220 | 2288 | |
| 2221 | − 1 2 3 4 5 6 7 8 | |
| 2289 | + 1 2 3 4 5 6 7 8 | |
| 2222 | 2290 | |
| 2223 | −2E0----- 0 0 0 1 0 0 0 1 | |
| 2224 | −2F0----- 0 0 0 1 0 0 0 0 | |
| 2225 | −300----- 0 0 0 0 1 1 1 1 | |
| 2226 | −350----- 0 0 0 0 1 1 1 0 | |
| 2291 | + 2E0----- 0 0 0 1 0 0 0 1 | |
| 2292 | + 2F0----- 0 0 0 1 0 0 0 0 | |
| 2293 | + 300----- 0 0 0 0 1 1 1 1 | |
| 2294 | + 350----- 0 0 0 0 1 1 1 0 | |
| 2227 | 2295 | |
| 2228 | 2296 | "0" in the above example means switch is off "1" means that it is on. |
| 2229 | 2297 | |
| 2298 | +:: | |
| 2230 | 2299 | |
| 2231 | − ShMem address. | |
| 2300 | + ShMem address. | |
| 2232 | 2301 | |
| 2233 | − 1 2 3 4 5 6 7 8 | |
| 2302 | + 1 2 3 4 5 6 7 8 | |
| 2234 | 2303 | |
| 2235 | −CX00--0 0 1 1 | | | | |
| 2236 | −DX00--0 0 1 0 | | |
| 2237 | −X000--------- 1 1 | | |
| 2238 | −X400--------- 1 0 | | |
| 2239 | −X800--------- 0 1 | | |
| 2240 | −XC00--------- 0 0 | |
| 2241 | −ENHANCED----------- 1 | |
| 2242 | −COMPATIBLE--------- 0 | |
| 2304 | + CX00--0 0 1 1 | | | | |
| 2305 | + DX00--0 0 1 0 | | |
| 2306 | + X000--------- 1 1 | | |
| 2307 | + X400--------- 1 0 | | |
| 2308 | + X800--------- 0 1 | | |
| 2309 | + XC00--------- 0 0 | |
| 2310 | + ENHANCED----------- 1 | |
| 2311 | + COMPATIBLE--------- 0 | |
| 2243 | 2312 | |
| 2313 | +:: | |
| 2244 | 2314 | |
| 2245 | − IRQ | |
| 2315 | + IRQ | |
| 2246 | 2316 | |
| 2247 | 2317 | |
| 2248 | − 3 4 5 7 2 | |
| 2249 | − . . . . . | |
| 2250 | − . . . . . | |
| 2318 | + 3 4 5 7 2 | |
| 2319 | + . . . . . | |
| 2320 | + . . . . . | |
| 2251 | 2321 | |
| 2252 | 2322 | |
| 2253 | 2323 | There is a DIP-switch with 8 switches, used to set the shared memory address |
| @@ -2266,10 +2336,9 @@ varies by the type of card involved. I fail to see how either of these · 12 unmodified lines | ||
| 2266 | 2336 | enhance anything. Send me more detailed information about this mode, or |
| 2267 | 2337 | just use "compatible" mode instead.] |
| 2268 | 2338 | |
| 2339 | +Waterloo Microsystems Inc. ?? | |
| 2340 | +============================= | |
| 2269 | 2341 | |
| 2270 | −***************************************************************************** | |
| 2271 | − | |
| 2272 | −** Waterloo Microsystems Inc. ?? ** | |
| 2273 | 2342 | 8-bit card (C) 1985 |
| 2274 | 2343 | ------------------- |
| 2275 | 2344 | - from Robert Michael Best <rmb117@cs.usask.ca> |
| @@ -2283,103 +2352,104 @@ e-mail me.] · 7 unmodified lines | ||
| 2283 | 2352 | |
| 2284 | 2353 | The probe has not been able to detect the card on any of the J2 settings, |
| 2285 | 2354 | and I tried them again with the "Waterloo" chip removed. |
| 2286 | − | |
| 2287 | − _____________________________________________________________________ | |
| 2288 | −| \/ \/ ___ __ __ | | |
| 2289 | −| C4 C4 |^| | M || ^ ||^| | | |
| 2290 | −| -- -- |_| | 5 || || | C3 | | |
| 2291 | −| \/ \/ C10 |___|| ||_| | | |
| 2292 | −| C4 C4 _ _ | | ?? | | |
| 2293 | −| -- -- | \/ || | | | |
| 2294 | −| | || | | | |
| 2295 | −| | || C1 | | | |
| 2296 | −| | || | \/ _____| | |
| 2297 | −| | C6 || | C9 | |___ | |
| 2298 | −| | || | -- | BNC |___| | |
| 2299 | −| | || | >C7| |_____| | |
| 2300 | −| | || | | | |
| 2301 | −| __ __ |____||_____| 1 2 3 6 | | |
| 2302 | −|| ^ | >C4| |o|o|o|o|o|o| J2 >C4| | | |
| 2303 | −|| | |o|o|o|o|o|o| | | |
| 2304 | −|| C2 | >C4| >C4| | | |
| 2305 | −|| | >C8| | | |
| 2306 | −|| | 2 3 4 5 6 7 IRQ >C4| | | |
| 2307 | −||_____| |o|o|o|o|o|o| J3 | | |
| 2308 | −|_______ |o|o|o|o|o|o| _______________| | |
| 2309 | − | | | |
| 2310 | − |_____________________________________________| | |
| 2311 | − | |
| 2312 | −C1 -- "COM9026 | |
| 2313 | − SMC 8638" | |
| 2314 | − In a chip socket. | |
| 2315 | − | |
| 2316 | −C2 -- "@Copyright | |
| 2317 | − Waterloo Microsystems Inc. | |
| 2318 | − 1985" | |
| 2319 | − In a chip Socket with info printed on a label covering a round window | |
| 2320 | − showing the circuit inside. (The window indicates it is an EPROM chip.) | |
| 2321 | − | |
| 2322 | −C3 -- "COM9032 | |
| 2323 | − SMC 8643" | |
| 2324 | − In a chip socket. | |
| 2325 | − | |
| 2326 | −C4 -- "74LS" | |
| 2327 | − 9 total no sockets. | |
| 2328 | − | |
| 2329 | −M5 -- "50006-136 | |
| 2330 | − 20.000000 MHZ | |
| 2331 | − MTQ-T1-S3 | |
| 2332 | − 0 M-TRON 86-40" | |
| 2333 | − Metallic case with 4 pins, no socket. | |
| 2334 | − | |
| 2335 | −C6 -- "MOSTEK@TC8643 | |
| 2336 | − MK6116N-20 | |
| 2337 | − MALAYSIA" | |
| 2338 | − No socket. | |
| 2339 | − | |
| 2340 | −C7 -- No stamp or label but in a 20 pin chip socket. | |
| 2341 | − | |
| 2342 | −C8 -- "PAL10L8CN | |
| 2343 | − 8623" | |
| 2344 | − In a 20 pin socket. | |
| 2345 | − | |
| 2346 | −C9 -- "PAl16R4A-2CN | |
| 2347 | − 8641" | |
| 2348 | − In a 20 pin socket. | |
| 2349 | − | |
| 2350 | −C10 -- "M8640 | |
| 2351 | − NMC | |
| 2352 | − 9306N" | |
| 2353 | − In an 8 pin socket. | |
| 2354 | − | |
| 2355 | −?? -- Some components on a smaller board and attached with 20 pins all | |
| 2356 | − along the side closest to the BNC connector. The are coated in a dark | |
| 2357 | − resin. | |
| 2358 | − | |
| 2359 | −On the board there are two jumper banks labeled J2 and J3. The | |
| 2360 | −manufacturer didn't put a J1 on the board. The two boards I have both | |
| 2355 | + | |
| 2356 | +:: | |
| 2357 | + | |
| 2358 | + _____________________________________________________________________ | |
| 2359 | + | \/ \/ ___ __ __ | | |
| 2360 | + | C4 C4 |^| | M || ^ ||^| | | |
| 2361 | + | -- -- |_| | 5 || || | C3 | | |
| 2362 | + | \/ \/ C10 |___|| ||_| | | |
| 2363 | + | C4 C4 _ _ | | ?? | | |
| 2364 | + | -- -- | \/ || | | | |
| 2365 | + | | || | | | |
| 2366 | + | | || C1 | | | |
| 2367 | + | | || | \/ _____| | |
| 2368 | + | | C6 || | C9 | |___ | |
| 2369 | + | | || | -- | BNC |___| | |
| 2370 | + | | || | >C7| |_____| | |
| 2371 | + | | || | | | |
| 2372 | + | __ __ |____||_____| 1 2 3 6 | | |
| 2373 | + || ^ | >C4| |o|o|o|o|o|o| J2 >C4| | | |
| 2374 | + || | |o|o|o|o|o|o| | | |
| 2375 | + || C2 | >C4| >C4| | | |
| 2376 | + || | >C8| | | |
| 2377 | + || | 2 3 4 5 6 7 IRQ >C4| | | |
| 2378 | + ||_____| |o|o|o|o|o|o| J3 | | |
| 2379 | + |_______ |o|o|o|o|o|o| _______________| | |
| 2380 | + | | | |
| 2381 | + |_____________________________________________| | |
| 2382 | + | |
| 2383 | + C1 -- "COM9026 | |
| 2384 | + SMC 8638" | |
| 2385 | + In a chip socket. | |
| 2386 | + | |
| 2387 | + C2 -- "@Copyright | |
| 2388 | + Waterloo Microsystems Inc. | |
| 2389 | + 1985" | |
| 2390 | + In a chip Socket with info printed on a label covering a round window | |
| 2391 | + showing the circuit inside. (The window indicates it is an EPROM chip.) | |
| 2392 | + | |
| 2393 | + C3 -- "COM9032 | |
| 2394 | + SMC 8643" | |
| 2395 | + In a chip socket. | |
| 2396 | + | |
| 2397 | + C4 -- "74LS" | |
| 2398 | + 9 total no sockets. | |
| 2399 | + | |
| 2400 | + M5 -- "50006-136 | |
| 2401 | + 20.000000 MHZ | |
| 2402 | + MTQ-T1-S3 | |
| 2403 | + 0 M-TRON 86-40" | |
| 2404 | + Metallic case with 4 pins, no socket. | |
| 2405 | + | |
| 2406 | + C6 -- "MOSTEK@TC8643 | |
| 2407 | + MK6116N-20 | |
| 2408 | + MALAYSIA" | |
| 2409 | + No socket. | |
| 2410 | + | |
| 2411 | + C7 -- No stamp or label but in a 20 pin chip socket. | |
| 2412 | + | |
| 2413 | + C8 -- "PAL10L8CN | |
| 2414 | + 8623" | |
| 2415 | + In a 20 pin socket. | |
| 2416 | + | |
| 2417 | + C9 -- "PAl16R4A-2CN | |
| 2418 | + 8641" | |
| 2419 | + In a 20 pin socket. | |
| 2420 | + | |
| 2421 | + C10 -- "M8640 | |
| 2422 | + NMC | |
| 2423 | + 9306N" | |
| 2424 | + In an 8 pin socket. | |
| 2425 | + | |
| 2426 | + ?? -- Some components on a smaller board and attached with 20 pins all | |
| 2427 | + along the side closest to the BNC connector. The are coated in a dark | |
| 2428 | + resin. | |
| 2429 | + | |
| 2430 | +On the board there are two jumper banks labeled J2 and J3. The | |
| 2431 | +manufacturer didn't put a J1 on the board. The two boards I have both | |
| 2361 | 2432 | came with a jumper box for each bank. |
| 2362 | 2433 | |
| 2363 | −J2 -- Numbered 1 2 3 4 5 6. | |
| 2364 | − 4 and 5 are not stamped due to solder points. | |
| 2365 | − | |
| 2366 | −J3 -- IRQ 2 3 4 5 6 7 | |
| 2434 | +:: | |
| 2435 | + | |
| 2436 | + J2 -- Numbered 1 2 3 4 5 6. | |
| 2437 | + 4 and 5 are not stamped due to solder points. | |
| 2438 | + | |
| 2439 | + J3 -- IRQ 2 3 4 5 6 7 | |
| 2367 | 2440 | |
| 2368 | −The board itself has a maple leaf stamped just above the irq jumpers | |
| 2369 | −and "-2 46-86" beside C2. Between C1 and C6 "ASS 'Y 300163" and "@1986 | |
| 2441 | +The board itself has a maple leaf stamped just above the irq jumpers | |
| 2442 | +and "-2 46-86" beside C2. Between C1 and C6 "ASS 'Y 300163" and "@1986 | |
| 2370 | 2443 | CORMAN CUSTOM ELECTRONICS CORP." stamped just below the BNC connector. |
| 2371 | 2444 | Below that "MADE IN CANADA" |
| 2372 | 2445 | |
| 2373 | − | |
| 2374 | −***************************************************************************** | |
| 2446 | +No Name | |
| 2447 | +======= | |
| 2375 | 2448 | |
| 2376 | −** No Name ** | |
| 2377 | 2449 | 8-bit cards, 16-bit cards |
| 2378 | 2450 | ------------------------- |
| 2451 | + | |
| 2379 | 2452 | - from Juergen Seifert <seifert@htwm.de> |
| 2380 | − | |
| 2381 | −NONAME 8-BIT ARCNET | |
| 2382 | −=================== | |
| 2383 | 2453 | |
| 2384 | 2454 | I have named this ARCnet card "NONAME", since there is no name of any |
| 2385 | 2455 | manufacturer on the Installation manual nor on the shipping box. The only |
| @@ -2388,8 +2458,10 @@ it is "Made in Taiwan" · 2 unmodified lines | ||
| 2388 | 2458 | |
| 2389 | 2459 | This description has been written by Juergen Seifert <seifert@htwm.de> |
| 2390 | 2460 | using information from the Original |
| 2391 | − "ARCnet Installation Manual" | |
| 2392 | 2461 | |
| 2462 | + "ARCnet Installation Manual" | |
| 2463 | + | |
| 2464 | +:: | |
| 2393 | 2465 | |
| 2394 | 2466 | ________________________________________________________________ |
| 2395 | 2467 | | |STAR| BUS| T/P| | |
| @@ -2416,32 +2488,32 @@ using information from the Original · 20 unmodified lines | ||
| 2416 | 2488 | | \ IRQ / T T O | |
| 2417 | 2489 | |__________________1_2_M______________________| |
| 2418 | 2490 | |
| 2419 | −Legend: | |
| 2491 | +Legend:: | |
| 2420 | 2492 | |
| 2421 | −COM90C65: ARCnet Probe | |
| 2422 | −S1 1-8: Node ID Select | |
| 2423 | −S2 1-3: I/O Base Address Select | |
| 2424 | − 4-6: Memory Base Address Select | |
| 2425 | − 7-8: RAM Offset Select | |
| 2426 | −ET1, ET2 Extended Timeout Select | |
| 2427 | −ROM ROM Enable Select | |
| 2428 | −CN RG62 Coax Connector | |
| 2429 | −STAR| BUS | T/P Three fields for placing a sign (colored circle) | |
| 2430 | − indicating the topology of the card | |
| 2493 | + COM90C65: ARCnet Probe | |
| 2494 | + S1 1-8: Node ID Select | |
| 2495 | + S2 1-3: I/O Base Address Select | |
| 2496 | + 4-6: Memory Base Address Select | |
| 2497 | + 7-8: RAM Offset Select | |
| 2498 | + ET1, ET2 Extended Timeout Select | |
| 2499 | + ROM ROM Enable Select | |
| 2500 | + CN RG62 Coax Connector | |
| 2501 | + STAR| BUS | T/P Three fields for placing a sign (colored circle) | |
| 2502 | + indicating the topology of the card | |
| 2431 | 2503 | |
| 2432 | 2504 | Setting one of the switches to Off means "1", On means "0". |
| 2433 | 2505 | |
| 2434 | 2506 | |
| 2435 | 2507 | Setting the Node ID |
| 2436 | −------------------- | |
| 2508 | +^^^^^^^^^^^^^^^^^^^ | |
| 2437 | 2509 | |
| 2438 | 2510 | The eight switches in group SW1 are used to set the node ID. |
| 2439 | 2511 | Each node attached to the network must have an unique node ID which |
| 2440 | 2512 | must be different from 0. |
| 2441 | 2513 | Switch 8 serves as the least significant bit (LSB). |
| 2442 | 2514 | |
| 2443 | −The node ID is the sum of the values of all switches set to "1" | |
| 2444 | −These values are: | |
| 2515 | +The node ID is the sum of the values of all switches set to "1" | |
| 2516 | +These values are:: | |
| 2445 | 2517 | |
| 2446 | 2518 | Switch | Value |
| 2447 | 2519 | -------|------- |
| @@ -2454,30 +2526,30 @@ These values are: · 6 unmodified lines | ||
| 2454 | 2526 | 2 | 64 |
| 2455 | 2527 | 1 | 128 |
| 2456 | 2528 | |
| 2457 | −Some Examples: | |
| 2529 | +Some Examples:: | |
| 2458 | 2530 | |
| 2459 | − Switch | Hex | Decimal | |
| 2531 | + Switch | Hex | Decimal | |
| 2460 | 2532 | 1 2 3 4 5 6 7 8 | Node ID | Node ID |
| 2461 | 2533 | ----------------|---------|--------- |
| 2462 | 2534 | 0 0 0 0 0 0 0 0 | not allowed |
| 2463 | − 0 0 0 0 0 0 0 1 | 1 | 1 | |
| 2535 | + 0 0 0 0 0 0 0 1 | 1 | 1 | |
| 2464 | 2536 | 0 0 0 0 0 0 1 0 | 2 | 2 |
| 2465 | 2537 | 0 0 0 0 0 0 1 1 | 3 | 3 |
| 2466 | 2538 | . . . | | |
| 2467 | 2539 | 0 1 0 1 0 1 0 1 | 55 | 85 |
| 2468 | 2540 | . . . | | |
| 2469 | 2541 | 1 0 1 0 1 0 1 0 | AA | 170 |
| 2470 | − . . . | | | |
| 2542 | + . . . | | | |
| 2471 | 2543 | 1 1 1 1 1 1 0 1 | FD | 253 |
| 2472 | 2544 | 1 1 1 1 1 1 1 0 | FE | 254 |
| 2473 | 2545 | 1 1 1 1 1 1 1 1 | FF | 255 |
| 2474 | 2546 | |
| 2475 | 2547 | |
| 2476 | 2548 | Setting the I/O Base Address |
| 2477 | −---------------------------- | |
| 2549 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2478 | 2550 | |
| 2479 | 2551 | The first three switches in switch group SW2 are used to select one |
| 2480 | −of eight possible I/O Base addresses using the following table | |
| 2552 | +of eight possible I/O Base addresses using the following table:: | |
| 2481 | 2553 | |
| 2482 | 2554 | Switch | Hex I/O |
| 2483 | 2555 | 1 2 3 | Address |
| @@ -2493,7 +2565,7 @@ of eight possible I/O Base addresses using the following table · 9 unmodified lines | ||
| 2493 | 2565 | |
| 2494 | 2566 | |
| 2495 | 2567 | Setting the Base Memory (RAM) buffer Address |
| 2496 | −-------------------------------------------- | |
| 2568 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2497 | 2569 | |
| 2498 | 2570 | The memory buffer requires 2K of a 16K block of RAM. The base of this |
| 2499 | 2571 | 16K block can be located in any of eight positions. |
| @@ -2501,6 +2573,8 @@ Switches 4-6 of switch group SW2 select the Base of the 16K block. · 1 unmodified line | ||
| 2501 | 2573 | Within that 16K address space, the buffer may be assigned any one of four |
| 2502 | 2574 | positions, determined by the offset, switches 7 and 8 of group SW2. |
| 2503 | 2575 | |
| 2576 | +:: | |
| 2577 | + | |
| 2504 | 2578 | Switch | Hex RAM | Hex ROM |
| 2505 | 2579 | 4 5 6 7 8 | Address | Address *) |
| 2506 | 2580 | -----------|---------|----------- |
| @@ -2508,60 +2582,62 @@ positions, determined by the offset, switches 7 and 8 of group SW2. · 1 unmodified line | ||
| 2508 | 2582 | 0 0 0 0 1 | C0800 | C2000 |
| 2509 | 2583 | 0 0 0 1 0 | C1000 | C2000 |
| 2510 | 2584 | 0 0 0 1 1 | C1800 | C2000 |
| 2511 | − | | | |
| 2585 | + | | | |
| 2512 | 2586 | 0 0 1 0 0 | C4000 | C6000 |
| 2513 | 2587 | 0 0 1 0 1 | C4800 | C6000 |
| 2514 | 2588 | 0 0 1 1 0 | C5000 | C6000 |
| 2515 | 2589 | 0 0 1 1 1 | C5800 | C6000 |
| 2516 | − | | | |
| 2590 | + | | | |
| 2517 | 2591 | 0 1 0 0 0 | CC000 | CE000 |
| 2518 | 2592 | 0 1 0 0 1 | CC800 | CE000 |
| 2519 | 2593 | 0 1 0 1 0 | CD000 | CE000 |
| 2520 | 2594 | 0 1 0 1 1 | CD800 | CE000 |
| 2521 | − | | | |
| 2595 | + | | | |
| 2522 | 2596 | 0 1 1 0 0 | D0000 | D2000 (Manufacturer's default) |
| 2523 | 2597 | 0 1 1 0 1 | D0800 | D2000 |
| 2524 | 2598 | 0 1 1 1 0 | D1000 | D2000 |
| 2525 | 2599 | 0 1 1 1 1 | D1800 | D2000 |
| 2526 | − | | | |
| 2600 | + | | | |
| 2527 | 2601 | 1 0 0 0 0 | D4000 | D6000 |
| 2528 | 2602 | 1 0 0 0 1 | D4800 | D6000 |
| 2529 | 2603 | 1 0 0 1 0 | D5000 | D6000 |
| 2530 | 2604 | 1 0 0 1 1 | D5800 | D6000 |
| 2531 | − | | | |
| 2605 | + | | | |
| 2532 | 2606 | 1 0 1 0 0 | D8000 | DA000 |
| 2533 | 2607 | 1 0 1 0 1 | D8800 | DA000 |
| 2534 | 2608 | 1 0 1 1 0 | D9000 | DA000 |
| 2535 | 2609 | 1 0 1 1 1 | D9800 | DA000 |
| 2536 | − | | | |
| 2610 | + | | | |
| 2537 | 2611 | 1 1 0 0 0 | DC000 | DE000 |
| 2538 | 2612 | 1 1 0 0 1 | DC800 | DE000 |
| 2539 | 2613 | 1 1 0 1 0 | DD000 | DE000 |
| 2540 | 2614 | 1 1 0 1 1 | DD800 | DE000 |
| 2541 | − | | | |
| 2615 | + | | | |
| 2542 | 2616 | 1 1 1 0 0 | E0000 | E2000 |
| 2543 | 2617 | 1 1 1 0 1 | E0800 | E2000 |
| 2544 | 2618 | 1 1 1 1 0 | E1000 | E2000 |
| 2545 | 2619 | 1 1 1 1 1 | E1800 | E2000 |
| 2546 | − | |
| 2547 | −*) To enable the 8K Boot PROM install the jumper ROM. | |
| 2548 | − The default is jumper ROM not installed. | |
| 2620 | + | |
| 2621 | + *) To enable the 8K Boot PROM install the jumper ROM. | |
| 2622 | + The default is jumper ROM not installed. | |
| 2549 | 2623 | |
| 2550 | 2624 | |
| 2551 | 2625 | Setting Interrupt Request Lines (IRQ) |
| 2552 | −------------------------------------- | |
| 2626 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2553 | 2627 | |
| 2554 | 2628 | To select a hardware interrupt level set one (only one!) of the jumpers |
| 2555 | 2629 | IRQ2, IRQ3, IRQ4, IRQ5 or IRQ7. The manufacturer's default is IRQ2. |
| 2556 | − | |
| 2630 | + | |
| 2557 | 2631 | |
| 2558 | 2632 | Setting the Timeouts |
| 2559 | −-------------------- | |
| 2633 | +^^^^^^^^^^^^^^^^^^^^ | |
| 2560 | 2634 | |
| 2561 | 2635 | The two jumpers labeled ET1 and ET2 are used to determine the timeout |
| 2562 | 2636 | parameters (response and reconfiguration time). Every node in a network |
| 2563 | 2637 | must be set to the same timeout values. |
| 2564 | 2638 | |
| 2639 | +:: | |
| 2640 | + | |
| 2565 | 2641 | ET1 ET2 | Response Time (us) | Reconfiguration Time (ms) |
| 2566 | 2642 | --------|--------------------|-------------------------- |
| 2567 | 2643 | Off Off | 78 | 840 (Default) |
| @@ -2572,8 +2648,8 @@ must be set to the same timeout values. · 4 unmodified lines | ||
| 2572 | 2648 | On means jumper installed, Off means jumper not installed |
| 2573 | 2649 | |
| 2574 | 2650 | |
| 2575 | −NONAME 16-BIT ARCNET | |
| 2576 | −==================== | |
| 2651 | +16-BIT ARCNET | |
| 2652 | +------------- | |
| 2577 | 2653 | |
| 2578 | 2654 | The manual of my 8-Bit NONAME ARCnet Card contains another description |
| 2579 | 2655 | of a 16-Bit Coax / Twisted Pair Card. This description is incomplete, |
| @@ -2584,13 +2660,16 @@ the booklet there is a different way of counting ... 2-9, 2-10, A-1, · 4 unmodified lines | ||
| 2584 | 2660 | Also the picture of the board layout is not as good as the picture of |
| 2585 | 2661 | 8-Bit card, because there isn't any letter like "SW1" written to the |
| 2586 | 2662 | picture. |
| 2663 | + | |
| 2587 | 2664 | Should somebody have such a board, please feel free to complete this |
| 2588 | 2665 | description or to send a mail to me! |
| 2589 | 2666 | |
| 2590 | 2667 | This description has been written by Juergen Seifert <seifert@htwm.de> |
| 2591 | 2668 | using information from the Original |
| 2592 | − "ARCnet Installation Manual" | |
| 2593 | 2669 | |
| 2670 | + "ARCnet Installation Manual" | |
| 2671 | + | |
| 2672 | +:: | |
| 2594 | 2673 | |
| 2595 | 2674 | ___________________________________________________________________ |
| 2596 | 2675 | < _________________ _________________ | |
| @@ -2622,15 +2701,15 @@ Setting one of the switches to Off means "1", On means "0". · 25 unmodified lines | ||
| 2622 | 2701 | |
| 2623 | 2702 | |
| 2624 | 2703 | Setting the Node ID |
| 2625 | −------------------- | |
| 2704 | +^^^^^^^^^^^^^^^^^^^ | |
| 2626 | 2705 | |
| 2627 | 2706 | The eight switches in group SW2 are used to set the node ID. |
| 2628 | 2707 | Each node attached to the network must have an unique node ID which |
| 2629 | 2708 | must be different from 0. |
| 2630 | 2709 | Switch 8 serves as the least significant bit (LSB). |
| 2631 | 2710 | |
| 2632 | −The node ID is the sum of the values of all switches set to "1" | |
| 2633 | −These values are: | |
| 2711 | +The node ID is the sum of the values of all switches set to "1" | |
| 2712 | +These values are:: | |
| 2634 | 2713 | |
| 2635 | 2714 | Switch | Value |
| 2636 | 2715 | -------|------- |
| @@ -2643,30 +2722,30 @@ These values are: · 6 unmodified lines | ||
| 2643 | 2722 | 2 | 64 |
| 2644 | 2723 | 1 | 128 |
| 2645 | 2724 | |
| 2646 | −Some Examples: | |
| 2725 | +Some Examples:: | |
| 2647 | 2726 | |
| 2648 | − Switch | Hex | Decimal | |
| 2727 | + Switch | Hex | Decimal | |
| 2649 | 2728 | 1 2 3 4 5 6 7 8 | Node ID | Node ID |
| 2650 | 2729 | ----------------|---------|--------- |
| 2651 | 2730 | 0 0 0 0 0 0 0 0 | not allowed |
| 2652 | − 0 0 0 0 0 0 0 1 | 1 | 1 | |
| 2731 | + 0 0 0 0 0 0 0 1 | 1 | 1 | |
| 2653 | 2732 | 0 0 0 0 0 0 1 0 | 2 | 2 |
| 2654 | 2733 | 0 0 0 0 0 0 1 1 | 3 | 3 |
| 2655 | 2734 | . . . | | |
| 2656 | 2735 | 0 1 0 1 0 1 0 1 | 55 | 85 |
| 2657 | 2736 | . . . | | |
| 2658 | 2737 | 1 0 1 0 1 0 1 0 | AA | 170 |
| 2659 | − . . . | | | |
| 2738 | + . . . | | | |
| 2660 | 2739 | 1 1 1 1 1 1 0 1 | FD | 253 |
| 2661 | 2740 | 1 1 1 1 1 1 1 0 | FE | 254 |
| 2662 | 2741 | 1 1 1 1 1 1 1 1 | FF | 255 |
| 2663 | 2742 | |
| 2664 | 2743 | |
| 2665 | 2744 | Setting the I/O Base Address |
| 2666 | −---------------------------- | |
| 2745 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2667 | 2746 | |
| 2668 | 2747 | The first three switches in switch group SW1 are used to select one |
| 2669 | −of eight possible I/O Base addresses using the following table | |
| 2748 | +of eight possible I/O Base addresses using the following table:: | |
| 2670 | 2749 | |
| 2671 | 2750 | Switch | Hex I/O |
| 2672 | 2751 | 3 2 1 | Address |
| @@ -2682,13 +2761,13 @@ of eight possible I/O Base addresses using the following table · 9 unmodified lines | ||
| 2682 | 2761 | |
| 2683 | 2762 | |
| 2684 | 2763 | Setting the Base Memory (RAM) buffer Address |
| 2685 | −-------------------------------------------- | |
| 2764 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2686 | 2765 | |
| 2687 | 2766 | The memory buffer requires 2K of a 16K block of RAM. The base of this |
| 2688 | 2767 | 16K block can be located in any of eight positions. |
| 2689 | 2768 | Switches 6-8 of switch group SW1 select the Base of the 16K block. |
| 2690 | 2769 | Within that 16K address space, the buffer may be assigned any one of four |
| 2691 | −positions, determined by the offset, switches 4 and 5 of group SW1. | |
| 2770 | +positions, determined by the offset, switches 4 and 5 of group SW1:: | |
| 2692 | 2771 | |
| 2693 | 2772 | Switch | Hex RAM | Hex ROM |
| 2694 | 2773 | 8 7 6 5 4 | Address | Address |
| @@ -2697,111 +2776,111 @@ positions, determined by the offset, switches 4 and 5 of group SW1. · 2 unmodified lines | ||
| 2697 | 2776 | 0 0 0 0 1 | C0800 | C2000 |
| 2698 | 2777 | 0 0 0 1 0 | C1000 | C2000 |
| 2699 | 2778 | 0 0 0 1 1 | C1800 | C2000 |
| 2700 | − | | | |
| 2779 | + | | | |
| 2701 | 2780 | 0 0 1 0 0 | C4000 | C6000 |
| 2702 | 2781 | 0 0 1 0 1 | C4800 | C6000 |
| 2703 | 2782 | 0 0 1 1 0 | C5000 | C6000 |
| 2704 | 2783 | 0 0 1 1 1 | C5800 | C6000 |
| 2705 | − | | | |
| 2784 | + | | | |
| 2706 | 2785 | 0 1 0 0 0 | CC000 | CE000 |
| 2707 | 2786 | 0 1 0 0 1 | CC800 | CE000 |
| 2708 | 2787 | 0 1 0 1 0 | CD000 | CE000 |
| 2709 | 2788 | 0 1 0 1 1 | CD800 | CE000 |
| 2710 | − | | | |
| 2789 | + | | | |
| 2711 | 2790 | 0 1 1 0 0 | D0000 | D2000 (Manufacturer's default) |
| 2712 | 2791 | 0 1 1 0 1 | D0800 | D2000 |
| 2713 | 2792 | 0 1 1 1 0 | D1000 | D2000 |
| 2714 | 2793 | 0 1 1 1 1 | D1800 | D2000 |
| 2715 | − | | | |
| 2794 | + | | | |
| 2716 | 2795 | 1 0 0 0 0 | D4000 | D6000 |
| 2717 | 2796 | 1 0 0 0 1 | D4800 | D6000 |
| 2718 | 2797 | 1 0 0 1 0 | D5000 | D6000 |
| 2719 | 2798 | 1 0 0 1 1 | D5800 | D6000 |
| 2720 | − | | | |
| 2799 | + | | | |
| 2721 | 2800 | 1 0 1 0 0 | D8000 | DA000 |
| 2722 | 2801 | 1 0 1 0 1 | D8800 | DA000 |
| 2723 | 2802 | 1 0 1 1 0 | D9000 | DA000 |
| 2724 | 2803 | 1 0 1 1 1 | D9800 | DA000 |
| 2725 | − | | | |
| 2804 | + | | | |
| 2726 | 2805 | 1 1 0 0 0 | DC000 | DE000 |
| 2727 | 2806 | 1 1 0 0 1 | DC800 | DE000 |
| 2728 | 2807 | 1 1 0 1 0 | DD000 | DE000 |
| 2729 | 2808 | 1 1 0 1 1 | DD800 | DE000 |
| 2730 | − | | | |
| 2809 | + | | | |
| 2731 | 2810 | 1 1 1 0 0 | E0000 | E2000 |
| 2732 | 2811 | 1 1 1 0 1 | E0800 | E2000 |
| 2733 | 2812 | 1 1 1 1 0 | E1000 | E2000 |
| 2734 | 2813 | 1 1 1 1 1 | E1800 | E2000 |
| 2735 | − | |
| 2814 | + | |
| 2736 | 2815 | |
| 2737 | 2816 | Setting Interrupt Request Lines (IRQ) |
| 2738 | −------------------------------------- | |
| 2817 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2739 | 2818 | |
| 2740 | 2819 | ?????????????????????????????????????? |
| 2741 | 2820 | |
| 2742 | 2821 | |
| 2743 | 2822 | Setting the Timeouts |
| 2744 | −-------------------- | |
| 2823 | +^^^^^^^^^^^^^^^^^^^^ | |
| 2745 | 2824 | |
| 2746 | 2825 | ?????????????????????????????????????? |
| 2747 | 2826 | |
| 2748 | 2827 | |
| 2749 | −***************************************************************************** | |
| 2750 | − | |
| 2751 | −** No Name ** | |
| 2752 | 2828 | 8-bit cards ("Made in Taiwan R.O.C.") |
| 2753 | −----------- | |
| 2829 | +------------------------------------- | |
| 2830 | + | |
| 2754 | 2831 | - from Vojtech Pavlik <vojtech@suse.cz> |
| 2755 | 2832 | |
| 2756 | 2833 | I have named this ARCnet card "NONAME", since I got only the card with |
| 2757 | −no manual at all and the only text identifying the manufacturer is | |
| 2834 | +no manual at all and the only text identifying the manufacturer is | |
| 2758 | 2835 | "MADE IN TAIWAN R.O.C" printed on the card. |
| 2759 | 2836 | |
| 2760 | − ____________________________________________________________ | |
| 2761 | − | 1 2 3 4 5 6 7 8 | | |
| 2762 | − | |o|o| JP1 o|o|o|o|o|o|o|o| ON | | |
| 2763 | − | + o|o|o|o|o|o|o|o| ___| | |
| 2764 | − | _____________ o|o|o|o|o|o|o|o| OFF _____ | | ID7 | |
| 2765 | − | | | SW1 | | | | ID6 | |
| 2766 | − | > RAM (2k) | ____________________ | H | | S | ID5 | |
| 2767 | − | |_____________| | || y | | W | ID4 | |
| 2768 | − | | || b | | 2 | ID3 | |
| 2769 | − | | || r | | | ID2 | |
| 2770 | − | | || i | | | ID1 | |
| 2771 | − | | 90C65 || d | |___| ID0 | |
| 2772 | − | SW3 | || | | | |
| 2773 | − | |o|o|o|o|o|o|o|o| ON | || I | | | |
| 2774 | − | |o|o|o|o|o|o|o|o| | || C | | | |
| 2775 | − | |o|o|o|o|o|o|o|o| OFF |____________________|| | _____| | |
| 2776 | − | 1 2 3 4 5 6 7 8 | | | |___ | |
| 2777 | − | ______________ | | | BNC |___| | |
| 2778 | − | | | |_____| |_____| | |
| 2779 | − | > EPROM SOCKET | | | |
| 2780 | − | |______________| | | |
| 2781 | − | ______________| | |
| 2782 | − | | | |
| 2783 | − |_____________________________________________| | |
| 2784 | − | |
| 2785 | −Legend: | |
| 2786 | − | |
| 2787 | −90C65 ARCNET Chip | |
| 2788 | −SW1 1-5: Base Memory Address Select | |
| 2789 | − 6-8: Base I/O Address Select | |
| 2790 | −SW2 1-8: Node ID Select (ID0-ID7) | |
| 2791 | −SW3 1-5: IRQ Select | |
| 2792 | − 6-7: Extra Timeout | |
| 2793 | − 8 : ROM Enable | |
| 2794 | −JP1 Led connector | |
| 2795 | −BNC Coax connector | |
| 2796 | − | |
| 2797 | −Although the jumpers SW1 and SW3 are marked SW, not JP, they are jumpers, not | |
| 2837 | +:: | |
| 2838 | + | |
| 2839 | + ____________________________________________________________ | |
| 2840 | + | 1 2 3 4 5 6 7 8 | | |
| 2841 | + | |o|o| JP1 o|o|o|o|o|o|o|o| ON | | |
| 2842 | + | + o|o|o|o|o|o|o|o| ___| | |
| 2843 | + | _____________ o|o|o|o|o|o|o|o| OFF _____ | | ID7 | |
| 2844 | + | | | SW1 | | | | ID6 | |
| 2845 | + | > RAM (2k) | ____________________ | H | | S | ID5 | |
| 2846 | + | |_____________| | || y | | W | ID4 | |
| 2847 | + | | || b | | 2 | ID3 | |
| 2848 | + | | || r | | | ID2 | |
| 2849 | + | | || i | | | ID1 | |
| 2850 | + | | 90C65 || d | |___| ID0 | |
| 2851 | + | SW3 | || | | | |
| 2852 | + | |o|o|o|o|o|o|o|o| ON | || I | | | |
| 2853 | + | |o|o|o|o|o|o|o|o| | || C | | | |
| 2854 | + | |o|o|o|o|o|o|o|o| OFF |____________________|| | _____| | |
| 2855 | + | 1 2 3 4 5 6 7 8 | | | |___ | |
| 2856 | + | ______________ | | | BNC |___| | |
| 2857 | + | | | |_____| |_____| | |
| 2858 | + | > EPROM SOCKET | | | |
| 2859 | + | |______________| | | |
| 2860 | + | ______________| | |
| 2861 | + | | | |
| 2862 | + |_____________________________________________| | |
| 2863 | + | |
| 2864 | +Legend:: | |
| 2865 | + | |
| 2866 | + 90C65 ARCNET Chip | |
| 2867 | + SW1 1-5: Base Memory Address Select | |
| 2868 | + 6-8: Base I/O Address Select | |
| 2869 | + SW2 1-8: Node ID Select (ID0-ID7) | |
| 2870 | + SW3 1-5: IRQ Select | |
| 2871 | + 6-7: Extra Timeout | |
| 2872 | + 8 : ROM Enable | |
| 2873 | + JP1 Led connector | |
| 2874 | + BNC Coax connector | |
| 2875 | + | |
| 2876 | +Although the jumpers SW1 and SW3 are marked SW, not JP, they are jumpers, not | |
| 2798 | 2877 | switches. |
| 2799 | 2878 | |
| 2800 | −Setting the jumpers to ON means connecting the upper two pins, off the bottom | |
| 2879 | +Setting the jumpers to ON means connecting the upper two pins, off the bottom | |
| 2801 | 2880 | two - or - in case of IRQ setting, connecting none of them at all. |
| 2802 | 2881 | |
| 2803 | 2882 | Setting the Node ID |
| 2804 | −------------------- | |
| 2883 | +^^^^^^^^^^^^^^^^^^^ | |
| 2805 | 2884 | |
| 2806 | 2885 | The eight switches in SW2 are used to set the node ID. Each node attached |
| 2807 | 2886 | to the network must have an unique node ID which must not be 0. |
| @@ -2809,8 +2888,8 @@ Switch 1 (ID0) serves as the least significant bit (LSB). · 1 unmodified line | ||
| 2809 | 2888 | |
| 2810 | 2889 | Setting one of the switches to Off means "1", On means "0". |
| 2811 | 2890 | |
| 2812 | −The node ID is the sum of the values of all switches set to "1" | |
| 2813 | −These values are: | |
| 2891 | +The node ID is the sum of the values of all switches set to "1" | |
| 2892 | +These values are:: | |
| 2814 | 2893 | |
| 2815 | 2894 | Switch | Label | Value |
| 2816 | 2895 | -------|-------|------- |
| @@ -2823,30 +2902,30 @@ These values are: · 6 unmodified lines | ||
| 2823 | 2902 | 7 | ID6 | 64 |
| 2824 | 2903 | 8 | ID7 | 128 |
| 2825 | 2904 | |
| 2826 | −Some Examples: | |
| 2905 | +Some Examples:: | |
| 2827 | 2906 | |
| 2828 | − Switch | Hex | Decimal | |
| 2907 | + Switch | Hex | Decimal | |
| 2829 | 2908 | 8 7 6 5 4 3 2 1 | Node ID | Node ID |
| 2830 | 2909 | ----------------|---------|--------- |
| 2831 | 2910 | 0 0 0 0 0 0 0 0 | not allowed |
| 2832 | − 0 0 0 0 0 0 0 1 | 1 | 1 | |
| 2911 | + 0 0 0 0 0 0 0 1 | 1 | 1 | |
| 2833 | 2912 | 0 0 0 0 0 0 1 0 | 2 | 2 |
| 2834 | 2913 | 0 0 0 0 0 0 1 1 | 3 | 3 |
| 2835 | 2914 | . . . | | |
| 2836 | 2915 | 0 1 0 1 0 1 0 1 | 55 | 85 |
| 2837 | 2916 | . . . | | |
| 2838 | 2917 | 1 0 1 0 1 0 1 0 | AA | 170 |
| 2839 | − . . . | | | |
| 2918 | + . . . | | | |
| 2840 | 2919 | 1 1 1 1 1 1 0 1 | FD | 253 |
| 2841 | 2920 | 1 1 1 1 1 1 1 0 | FE | 254 |
| 2842 | 2921 | 1 1 1 1 1 1 1 1 | FF | 255 |
| 2843 | 2922 | |
| 2844 | 2923 | |
| 2845 | 2924 | Setting the I/O Base Address |
| 2846 | −---------------------------- | |
| 2925 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2847 | 2926 | |
| 2848 | 2927 | The last three switches in switch block SW1 are used to select one |
| 2849 | −of eight possible I/O Base addresses using the following table | |
| 2928 | +of eight possible I/O Base addresses using the following table:: | |
| 2850 | 2929 | |
| 2851 | 2930 | |
| 2852 | 2931 | Switch | Hex I/O |
| @@ -2863,13 +2942,16 @@ of eight possible I/O Base addresses using the following table · 10 unmodified lines | ||
| 2863 | 2942 | |
| 2864 | 2943 | |
| 2865 | 2944 | Setting the Base Memory (RAM) buffer Address |
| 2866 | −-------------------------------------------- | |
| 2945 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2867 | 2946 | |
| 2868 | −The memory buffer (RAM) requires 2K. The base of this buffer can be | |
| 2947 | +The memory buffer (RAM) requires 2K. The base of this buffer can be | |
| 2869 | 2948 | located in any of eight positions. The address of the Boot Prom is |
| 2870 | 2949 | memory base + 0x2000. |
| 2950 | + | |
| 2871 | 2951 | Jumpers 3-5 of jumper block SW1 select the Memory Base address. |
| 2872 | 2952 | |
| 2953 | +:: | |
| 2954 | + | |
| 2873 | 2955 | Switch | Hex RAM | Hex ROM |
| 2874 | 2956 | 1 2 3 4 5 | Address | Address *) |
| 2875 | 2957 | --------------------|---------|----------- |
| @@ -2881,15 +2963,15 @@ Jumpers 3-5 of jumper block SW1 select the Memory Base address. · 5 unmodified lines | ||
| 2881 | 2963 | ON ON OFF ON OFF | D8000 | DA000 |
| 2882 | 2964 | ON ON ON OFF OFF | DC000 | DE000 |
| 2883 | 2965 | ON ON OFF OFF OFF | E0000 | E2000 |
| 2884 | − | |
| 2885 | −*) To enable the Boot ROM set the jumper 8 of jumper block SW3 to position ON. | |
| 2966 | + | |
| 2967 | + *) To enable the Boot ROM set the jumper 8 of jumper block SW3 to position ON. | |
| 2886 | 2968 | |
| 2887 | 2969 | The jumpers 1 and 2 probably add 0x0800, 0x1000 and 0x1800 to RAM adders. |
| 2888 | 2970 | |
| 2889 | 2971 | Setting the Interrupt Line |
| 2890 | −-------------------------- | |
| 2972 | +^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2891 | 2973 | |
| 2892 | −Jumpers 1-5 of the jumper block SW3 control the IRQ level. | |
| 2974 | +Jumpers 1-5 of the jumper block SW3 control the IRQ level:: | |
| 2893 | 2975 | |
| 2894 | 2976 | Jumper | IRQ |
| 2895 | 2977 | 1 2 3 4 5 | |
| @@ -2902,23 +2984,24 @@ Jumpers 1-5 of the jumper block SW3 control the IRQ level. · 6 unmodified lines | ||
| 2902 | 2984 | |
| 2903 | 2985 | |
| 2904 | 2986 | Setting the Timeout Parameters |
| 2905 | −------------------------------ | |
| 2987 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2906 | 2988 | |
| 2907 | −The jumpers 6-7 of the jumper block SW3 are used to determine the timeout | |
| 2989 | +The jumpers 6-7 of the jumper block SW3 are used to determine the timeout | |
| 2908 | 2990 | parameters. These two jumpers are normally left in the OFF position. |
| 2909 | 2991 | |
| 2910 | 2992 | |
| 2911 | −***************************************************************************** | |
| 2912 | 2993 | |
| 2913 | −** No Name ** | |
| 2914 | 2994 | (Generic Model 9058) |
| 2915 | 2995 | -------------------- |
| 2916 | 2996 | - from Andrew J. Kroll <ag784@freenet.buffalo.edu> |
| 2917 | 2997 | - Sorry this sat in my to-do box for so long, Andrew! (yikes - over a |
| 2918 | 2998 | year!) |
| 2919 | − _____ | |
| 2920 | − | < | |
| 2921 | − | .---' | |
| 2999 | + | |
| 3000 | +:: | |
| 3001 | + | |
| 3002 | + _____ | |
| 3003 | + | < | |
| 3004 | + | .---' | |
| 2922 | 3005 | ________________________________________________________________ | | |
| 2923 | 3006 | | | SW2 | | | |
| 2924 | 3007 | | ___________ |_____________| | | |
| @@ -2936,7 +3019,7 @@ parameters. These two jumpers are normally left in the OFF position. · 11 unmodified lines | ||
| 2936 | 3019 | | |________________| | | : B |- | | |
| 2937 | 3020 | | 1 2 3 4 5 6 7 8 | | : O |- | | |
| 2938 | 3021 | | |_________o____|..../ A |- _______| | |
| 2939 | − | ____________________ | R |- | |------, | |
| 3022 | + | ____________________ | R |- | |------, | |
| 2940 | 3023 | | | | | D |- | BNC | # | |
| 2941 | 3024 | | > 2764 PROM SOCKET | |__________|- |_______|------' |
| 2942 | 3025 | | |____________________| _________ | | |
| @@ -2945,23 +3028,24 @@ parameters. These two jumpers are normally left in the OFF position. · 2 unmodified lines | ||
| 2945 | 3028 | |___ ______________| | |
| 2946 | 3029 | |H H H H H H H H H H H H H H H H H H H H H H H| | | |
| 2947 | 3030 | |U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U_U| | | |
| 2948 | − \| | |
| 2949 | −Legend: | |
| 3031 | + \| | |
| 3032 | + | |
| 3033 | +Legend:: | |
| 2950 | 3034 | |
| 2951 | −SL90C65 ARCNET Controller / Transceiver /Logic | |
| 2952 | −SW1 1-5: IRQ Select | |
| 3035 | + SL90C65 ARCNET Controller / Transceiver /Logic | |
| 3036 | + SW1 1-5: IRQ Select | |
| 2953 | 3037 | 6: ET1 |
| 2954 | 3038 | 7: ET2 |
| 2955 | − 8: ROM ENABLE | |
| 2956 | −SW2 1-3: Memory Buffer/PROM Address | |
| 3039 | + 8: ROM ENABLE | |
| 3040 | + SW2 1-3: Memory Buffer/PROM Address | |
| 2957 | 3041 | 3-6: I/O Address Map |
| 2958 | −SW3 1-8: Node ID Select | |
| 2959 | −BNC BNC RG62/U Connection | |
| 3042 | + SW3 1-8: Node ID Select | |
| 3043 | + BNC BNC RG62/U Connection | |
| 2960 | 3044 | *I* have had success using RG59B/U with *NO* terminators! |
| 2961 | 3045 | What gives?! |
| 2962 | 3046 | |
| 2963 | 3047 | SW1: Timeouts, Interrupt and ROM |
| 2964 | −--------------------------------- | |
| 3048 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2965 | 3049 | |
| 2966 | 3050 | To select a hardware interrupt level set one (only one!) of the dip switches |
| 2967 | 3051 | up (on) SW1...(switches 1-5) |
| @@ -2976,10 +3060,10 @@ are normally left off (down). · 8 unmodified lines | ||
| 2976 | 3060 | |
| 2977 | 3061 | |
| 2978 | 3062 | Setting the I/O Base Address |
| 2979 | −---------------------------- | |
| 3063 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 2980 | 3064 | |
| 2981 | 3065 | The last three switches in switch group SW2 are used to select one |
| 2982 | −of eight possible I/O Base addresses using the following table | |
| 3066 | +of eight possible I/O Base addresses using the following table:: | |
| 2983 | 3067 | |
| 2984 | 3068 | |
| 2985 | 3069 | Switch | Hex I/O |
| @@ -2996,7 +3080,7 @@ of eight possible I/O Base addresses using the following table · 10 unmodified lines | ||
| 2996 | 3080 | |
| 2997 | 3081 | |
| 2998 | 3082 | Setting the Base Memory Address (RAM & ROM) |
| 2999 | −------------------------------------------- | |
| 3083 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 3000 | 3084 | |
| 3001 | 3085 | The memory buffer requires 2K of a 16K block of RAM. The base of this |
| 3002 | 3086 | 16K block can be located in any of eight positions. |
| @@ -3004,13 +3088,16 @@ Switches 1-3 of switch group SW2 select the Base of the 16K block. · 1 unmodified line | ||
| 3004 | 3088 | (0 = DOWN, 1 = UP) |
| 3005 | 3089 | I could, however, only verify two settings... |
| 3006 | 3090 | |
| 3091 | + | |
| 3092 | +:: | |
| 3093 | + | |
| 3007 | 3094 | Switch| Hex RAM | Hex ROM |
| 3008 | 3095 | 1 2 3 | Address | Address |
| 3009 | 3096 | ------|---------|----------- |
| 3010 | 3097 | 0 0 0 | E0000 | E2000 |
| 3011 | 3098 | 0 0 1 | D0000 | D2000 (Manufacturer's default) |
| 3012 | 3099 | 0 1 0 | ????? | ????? |
| 3013 | − 0 1 1 | ????? | ????? | |
| 3100 | + 0 1 1 | ????? | ????? | |
| 3014 | 3101 | 1 0 0 | ????? | ????? |
| 3015 | 3102 | 1 0 1 | ????? | ????? |
| 3016 | 3103 | 1 1 0 | ????? | ????? |
| @@ -3018,7 +3105,7 @@ I could, however, only verify two settings... · 1 unmodified line | ||
| 3018 | 3105 | |
| 3019 | 3106 | |
| 3020 | 3107 | Setting the Node ID |
| 3021 | −------------------- | |
| 3108 | +^^^^^^^^^^^^^^^^^^^ | |
| 3022 | 3109 | |
| 3023 | 3110 | The eight switches in group SW3 are used to set the node ID. |
| 3024 | 3111 | Each node attached to the network must have an unique node ID which |
| @@ -3026,8 +3113,9 @@ must be different from 0. · 1 unmodified line | ||
| 3026 | 3113 | Switch 1 serves as the least significant bit (LSB). |
| 3027 | 3114 | switches in the DOWN position are OFF (0) and in the UP position are ON (1) |
| 3028 | 3115 | |
| 3029 | −The node ID is the sum of the values of all switches set to "1" | |
| 3030 | −These values are: | |
| 3116 | +The node ID is the sum of the values of all switches set to "1" | |
| 3117 | +These values are:: | |
| 3118 | + | |
| 3031 | 3119 | Switch | Value |
| 3032 | 3120 | -------|------- |
| 3033 | 3121 | 1 | 1 |
| @@ -3039,70 +3127,80 @@ These values are: · 5 unmodified lines | ||
| 3039 | 3127 | 7 | 64 |
| 3040 | 3128 | 8 | 128 |
| 3041 | 3129 | |
| 3042 | −Some Examples: | |
| 3043 | − | |
| 3044 | − Switch# | Hex | Decimal | |
| 3045 | −8 7 6 5 4 3 2 1 | Node ID | Node ID | |
| 3046 | −----------------|---------|--------- | |
| 3047 | −0 0 0 0 0 0 0 0 | not allowed <-. | |
| 3048 | −0 0 0 0 0 0 0 1 | 1 | 1 | | |
| 3049 | −0 0 0 0 0 0 1 0 | 2 | 2 | | |
| 3050 | −0 0 0 0 0 0 1 1 | 3 | 3 | | |
| 3051 | − . . . | | | | |
| 3052 | −0 1 0 1 0 1 0 1 | 55 | 85 | | |
| 3053 | − . . . | | + Don't use 0 or 255! | |
| 3054 | −1 0 1 0 1 0 1 0 | AA | 170 | | |
| 3055 | − . . . | | | | |
| 3056 | −1 1 1 1 1 1 0 1 | FD | 253 | | |
| 3057 | −1 1 1 1 1 1 1 0 | FE | 254 | | |
| 3058 | −1 1 1 1 1 1 1 1 | FF | 255 <-' | |
| 3059 | − | |
| 3130 | +Some Examples:: | |
| 3060 | 3131 | |
| 3061 | −***************************************************************************** | |
| 3132 | + Switch# | Hex | Decimal | |
| 3133 | + 8 7 6 5 4 3 2 1 | Node ID | Node ID | |
| 3134 | + ----------------|---------|--------- | |
| 3135 | + 0 0 0 0 0 0 0 0 | not allowed <-. | |
| 3136 | + 0 0 0 0 0 0 0 1 | 1 | 1 | | |
| 3137 | + 0 0 0 0 0 0 1 0 | 2 | 2 | | |
| 3138 | + 0 0 0 0 0 0 1 1 | 3 | 3 | | |
| 3139 | + . . . | | | | |
| 3140 | + 0 1 0 1 0 1 0 1 | 55 | 85 | | |
| 3141 | + . . . | | + Don't use 0 or 255! | |
| 3142 | + 1 0 1 0 1 0 1 0 | AA | 170 | | |
| 3143 | + . . . | | | | |
| 3144 | + 1 1 1 1 1 1 0 1 | FD | 253 | | |
| 3145 | + 1 1 1 1 1 1 1 0 | FE | 254 | | |
| 3146 | + 1 1 1 1 1 1 1 1 | FF | 255 <-' | |
| 3147 | + | |
| 3148 | + | |
| 3149 | +Tiara | |
| 3150 | +===== | |
| 3062 | 3151 | |
| 3063 | −** Tiara ** | |
| 3064 | 3152 | (model unknown) |
| 3065 | −------------------------- | |
| 3153 | +--------------- | |
| 3154 | + | |
| 3066 | 3155 | - from Christoph Lameter <christoph@lameter.com> |
| 3067 | − | |
| 3068 | − | |
| 3069 | −Here is information about my card as far as I could figure it out: | |
| 3070 | −----------------------------------------------- tiara | |
| 3071 | −Tiara LanCard of Tiara Computer Systems. | |
| 3072 | − | |
| 3073 | −+----------------------------------------------+ | |
| 3074 | −! ! Transmitter Unit ! ! | |
| 3075 | −! +------------------+ ------- | |
| 3076 | −! MEM Coax Connector | |
| 3077 | −! ROM 7654321 <- I/O ------- | |
| 3078 | −! : : +--------+ ! | |
| 3079 | −! : : ! 90C66LJ! +++ | |
| 3080 | −! : : ! ! !D Switch to set | |
| 3081 | −! : : ! ! !I the Nodenumber | |
| 3082 | −! : : +--------+ !P | |
| 3083 | −! !++ | |
| 3084 | −! 234567 <- IRQ ! | |
| 3085 | −+------------!!!!!!!!!!!!!!!!!!!!!!!!--------+ | |
| 3086 | − !!!!!!!!!!!!!!!!!!!!!!!! | |
| 3087 | − | |
| 3088 | −0 = Jumper Installed | |
| 3089 | −1 = Open | |
| 3156 | + | |
| 3157 | + | |
| 3158 | +Here is information about my card as far as I could figure it out:: | |
| 3159 | + | |
| 3160 | + | |
| 3161 | + ----------------------------------------------- tiara | |
| 3162 | + Tiara LanCard of Tiara Computer Systems. | |
| 3163 | + | |
| 3164 | + +----------------------------------------------+ | |
| 3165 | + ! ! Transmitter Unit ! ! | |
| 3166 | + ! +------------------+ ------- | |
| 3167 | + ! MEM Coax Connector | |
| 3168 | + ! ROM 7654321 <- I/O ------- | |
| 3169 | + ! : : +--------+ ! | |
| 3170 | + ! : : ! 90C66LJ! +++ | |
| 3171 | + ! : : ! ! !D Switch to set | |
| 3172 | + ! : : ! ! !I the Nodenumber | |
| 3173 | + ! : : +--------+ !P | |
| 3174 | + ! !++ | |
| 3175 | + ! 234567 <- IRQ ! | |
| 3176 | + +------------!!!!!!!!!!!!!!!!!!!!!!!!--------+ | |
| 3177 | + !!!!!!!!!!!!!!!!!!!!!!!! | |
| 3178 | + | |
| 3179 | +- 0 = Jumper Installed | |
| 3180 | +- 1 = Open | |
| 3090 | 3181 | |
| 3091 | 3182 | Top Jumper line Bit 7 = ROM Enable 654=Memory location 321=I/O |
| 3092 | 3183 | |
| 3093 | 3184 | Settings for Memory Location (Top Jumper Line) |
| 3185 | + | |
| 3186 | +=== ================ | |
| 3094 | 3187 | 456 Address selected |
| 3188 | +=== ================ | |
| 3095 | 3189 | 000 C0000 |
| 3096 | 3190 | 001 C4000 |
| 3097 | 3191 | 010 CC000 |
| 3098 | 3192 | 011 D0000 |
| 3099 | 3193 | 100 D4000 |
| 3100 | 3194 | 101 D8000 |
| 3101 | −110 DC000 | |
| 3195 | +110 DC000 | |
| 3102 | 3196 | 111 E0000 |
| 3197 | +=== ================ | |
| 3103 | 3198 | |
| 3104 | 3199 | Settings for I/O Address (Top Jumper Line) |
| 3200 | + | |
| 3201 | +=== ==== | |
| 3105 | 3202 | 123 Port |
| 3203 | +=== ==== | |
| 3106 | 3204 | 000 260 |
| 3107 | 3205 | 001 290 |
| 3108 | 3206 | 010 2E0 |
| @@ -3111,23 +3209,26 @@ Settings for I/O Address (Top Jumper Line) · 2 unmodified lines | ||
| 3111 | 3209 | 101 350 |
| 3112 | 3210 | 110 380 |
| 3113 | 3211 | 111 3E0 |
| 3212 | +=== ==== | |
| 3114 | 3213 | |
| 3115 | 3214 | Settings for IRQ Selection (Lower Jumper Line) |
| 3215 | + | |
| 3216 | +====== ===== | |
| 3116 | 3217 | 234567 |
| 3218 | +====== ===== | |
| 3117 | 3219 | 011111 IRQ 2 |
| 3118 | 3220 | 101111 IRQ 3 |
| 3119 | 3221 | 110111 IRQ 4 |
| 3120 | 3222 | 111011 IRQ 5 |
| 3121 | 3223 | 111110 IRQ 7 |
| 3122 | − | |
| 3123 | −***************************************************************************** | |
| 3124 | − | |
| 3224 | +====== ===== | |
| 3125 | 3225 | |
| 3126 | 3226 | Other Cards |
| 3127 | −----------- | |
| 3227 | +=========== | |
| 3128 | 3228 | |
| 3129 | 3229 | I have no information on other models of ARCnet cards at the moment. Please |
| 3130 | 3230 | send any and all info to: |
| 3231 | + | |
| 3131 | 3232 | apenwarr@worldvisions.ca |
| 3132 | 3233 | |
| 3133 | 3234 | Thanks. |
| @@ -1,11 +1,18 @@ | ||
| 1 | −---------------------------------------------------------------------------- | |
| 2 | −NOTE: See also arcnet-hardware.txt in this directory for jumper-setting | |
| 3 | −and cabling information if you're like many of us and didn't happen to get a | |
| 4 | −manual with your ARCnet card. | |
| 5 | −---------------------------------------------------------------------------- | |
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +====== | |
| 4 | +ARCnet | |
| 5 | +====== | |
| 6 | + | |
| 7 | +.. note:: | |
| 8 | + | |
| 9 | + See also arcnet-hardware.txt in this directory for jumper-setting | |
| 10 | + and cabling information if you're like many of us and didn't happen to get a | |
| 11 | + manual with your ARCnet card. | |
| 6 | 12 | |
| 7 | 13 | Since no one seems to listen to me otherwise, perhaps a poem will get your |
| 8 | −attention: | |
| 14 | +attention:: | |
| 15 | + | |
| 9 | 16 | This driver's getting fat and beefy, |
| 10 | 17 | But my cat is still named Fifi. |
| 11 | 18 | |
| @@ -24,28 +31,21 @@ Come on, be a sport! Send me a success report! · 12 unmodified lines | ||
| 24 | 31 | (hey, that was even better than my original poem... this is getting bad!) |
| 25 | 32 | |
| 26 | 33 | |
| 27 | −-------- | |
| 28 | −WARNING: | |
| 29 | −-------- | |
| 30 | − | |
| 31 | −If you don't e-mail me about your success/failure soon, I may be forced to | |
| 32 | −start SINGING. And we don't want that, do we? | |
| 34 | +.. warning:: | |
| 33 | 35 | |
| 34 | −(You know, it might be argued that I'm pushing this point a little too much. | |
| 35 | −If you think so, why not flame me in a quick little e-mail? Please also | |
| 36 | −include the type of card(s) you're using, software, size of network, and | |
| 37 | −whether it's working or not.) | |
| 36 | + If you don't e-mail me about your success/failure soon, I may be forced to | |
| 37 | + start SINGING. And we don't want that, do we? | |
| 38 | 38 | |
| 39 | −My e-mail address is: apenwarr@worldvisions.ca | |
| 39 | + (You know, it might be argued that I'm pushing this point a little too much. | |
| 40 | + If you think so, why not flame me in a quick little e-mail? Please also | |
| 41 | + include the type of card(s) you're using, software, size of network, and | |
| 42 | + whether it's working or not.) | |
| 40 | 43 | |
| 44 | + My e-mail address is: apenwarr@worldvisions.ca | |
| 41 | 45 | |
| 42 | −--------------------------------------------------------------------------- | |
| 43 | − | |
| 44 | − | |
| 45 | 46 | These are the ARCnet drivers for Linux. |
| 46 | 47 | |
| 47 | − | |
| 48 | −This new release (2.91) has been put together by David Woodhouse | |
| 48 | +This new release (2.91) has been put together by David Woodhouse | |
| 49 | 49 | <dwmw2@infradead.org>, in an attempt to tidy up the driver after adding support |
| 50 | 50 | for yet another chipset. Now the generic support has been separated from the |
| 51 | 51 | individual chipset drivers, and the source files aren't quite so packed with |
| @@ -62,12 +62,13 @@ included and seems to be working fine! · 10 unmodified lines | ||
| 62 | 62 | Where do I discuss these drivers? |
| 63 | 63 | --------------------------------- |
| 64 | 64 | |
| 65 | −Tomasz has been so kind as to set up a new and improved mailing list. | |
| 65 | +Tomasz has been so kind as to set up a new and improved mailing list. | |
| 66 | 66 | Subscribe by sending a message with the BODY "subscribe linux-arcnet YOUR |
| 67 | 67 | REAL NAME" to listserv@tichy.ch.uj.edu.pl. Then, to submit messages to the |
| 68 | 68 | list, mail to linux-arcnet@tichy.ch.uj.edu.pl. |
| 69 | 69 | |
| 70 | 70 | There are archives of the mailing list at: |
| 71 | + | |
| 71 | 72 | http://epistolary.org/mailman/listinfo.cgi/arcnet |
| 72 | 73 | |
| 73 | 74 | The people on linux-net@vger.kernel.org (now defunct, replaced by |
| @@ -80,17 +81,20 @@ Other Drivers and Info · 6 unmodified lines | ||
| 80 | 81 | ---------------------- |
| 81 | 82 | |
| 82 | 83 | You can try my ARCNET page on the World Wide Web at: |
| 83 | − http://www.qis.net/~jschmitz/arcnet/ | |
| 84 | + | |
| 85 | + http://www.qis.net/~jschmitz/arcnet/ | |
| 84 | 86 | |
| 85 | 87 | Also, SMC (one of the companies that makes ARCnet cards) has a WWW site you |
| 86 | 88 | might be interested in, which includes several drivers for various cards |
| 87 | 89 | including ARCnet. Try: |
| 90 | + | |
| 88 | 91 | http://www.smc.com/ |
| 89 | − | |
| 92 | + | |
| 90 | 93 | Performance Technologies makes various network software that supports |
| 91 | 94 | ARCnet: |
| 95 | + | |
| 92 | 96 | http://www.perftech.com/ or ftp to ftp.perftech.com. |
| 93 | − | |
| 97 | + | |
| 94 | 98 | Novell makes a networking stack for DOS which includes ARCnet drivers. Try |
| 95 | 99 | FTPing to ftp.novell.com. |
| 96 | 100 | |
| @@ -99,19 +103,20 @@ one you'll want to use with ARCnet cards) from · 2 unmodified lines | ||
| 99 | 103 | oak.oakland.edu:/simtel/msdos/pktdrvr. It won't work perfectly on a 386+ |
| 100 | 104 | without patches, though, and also doesn't like several cards. Fixed |
| 101 | 105 | versions are available on my WWW page, or via e-mail if you don't have WWW |
| 102 | −access. | |
| 106 | +access. | |
| 103 | 107 | |
| 104 | 108 | |
| 105 | 109 | Installing the Driver |
| 106 | 110 | --------------------- |
| 107 | 111 | |
| 108 | −All you will need to do in order to install the driver is: | |
| 112 | +All you will need to do in order to install the driver is:: | |
| 113 | + | |
| 109 | 114 | make config |
| 110 | − (be sure to choose ARCnet in the network devices | |
| 115 | + (be sure to choose ARCnet in the network devices | |
| 111 | 116 | and at least one chipset driver.) |
| 112 | 117 | make clean |
| 113 | 118 | make zImage |
| 114 | − | |
| 119 | + | |
| 115 | 120 | If you obtained this ARCnet package as an upgrade to the ARCnet driver in |
| 116 | 121 | your current kernel, you will need to first copy arcnet.c over the one in |
| 117 | 122 | the linux/drivers/net directory. |
| @@ -125,10 +130,12 @@ There are four chipset options: · 7 unmodified lines | ||
| 125 | 130 | |
| 126 | 131 | This is the normal ARCnet card, which you've probably got. This is the only |
| 127 | 132 | chipset driver which will autoprobe if not told where the card is. |
| 128 | −It following options on the command line: | |
| 133 | +It following options on the command line:: | |
| 134 | + | |
| 129 | 135 | com90xx=[<io>[,<irq>[,<shmem>]]][,<name>] | <name> |
| 130 | 136 | |
| 131 | −If you load the chipset support as a module, the options are: | |
| 137 | +If you load the chipset support as a module, the options are:: | |
| 138 | + | |
| 132 | 139 | io=<io> irq=<irq> shmem=<shmem> device=<name> |
| 133 | 140 | |
| 134 | 141 | To disable the autoprobe, just specify "com90xx=" on the kernel command line. |
| @@ -136,14 +143,17 @@ To specify the name alone, but allow autoprobe, just put "com90xx=<name>" · 1 unmodified line | ||
| 136 | 143 | |
| 137 | 144 | 2. ARCnet COM20020 chipset. |
| 138 | 145 | |
| 139 | −This is the new chipset from SMC with support for promiscuous mode (packet | |
| 146 | +This is the new chipset from SMC with support for promiscuous mode (packet | |
| 140 | 147 | sniffing), extra diagnostic information, etc. Unfortunately, there is no |
| 141 | 148 | sensible method of autoprobing for these cards. You must specify the I/O |
| 142 | 149 | address on the kernel command line. |
| 143 | −The command line options are: | |
| 150 | + | |
| 151 | +The command line options are:: | |
| 152 | + | |
| 144 | 153 | com20020=<io>[,<irq>[,<node_ID>[,backplane[,CKP[,timeout]]]]][,name] |
| 145 | 154 | |
| 146 | −If you load the chipset support as a module, the options are: | |
| 155 | +If you load the chipset support as a module, the options are:: | |
| 156 | + | |
| 147 | 157 | io=<io> irq=<irq> node=<node_ID> backplane=<backplane> clock=<CKP> |
| 148 | 158 | timeout=<timeout> device=<name> |
| 149 | 159 | |
| @@ -160,8 +170,10 @@ you have a card which doesn't support shared memory, or (strangely) in case · 10 unmodified lines | ||
| 160 | 170 | you have so many ARCnet cards in your machine that you run out of shmem slots. |
| 161 | 171 | If you don't give the IO address on the kernel command line, then the driver |
| 162 | 172 | will not find the card. |
| 163 | −The command line options are: | |
| 164 | − com90io=<io>[,<irq>][,<name>] | |
| 173 | + | |
| 174 | +The command line options are:: | |
| 175 | + | |
| 176 | + com90io=<io>[,<irq>][,<name>] | |
| 165 | 177 | |
| 166 | 178 | If you load the chipset support as a module, the options are: |
| 167 | 179 | io=<io> irq=<irq> device=<name> |
| @@ -169,44 +181,49 @@ If you load the chipset support as a module, the options are: · 1 unmodified line | ||
| 169 | 181 | 4. ARCnet RIM I cards. |
| 170 | 182 | |
| 171 | 183 | These are COM90xx chips which are _completely_ memory mapped. The support for |
| 172 | −these is not tested. If you have one, please mail the author with a success | |
| 184 | +these is not tested. If you have one, please mail the author with a success | |
| 173 | 185 | report. All options must be specified, except the device name. |
| 174 | −Command line options: | |
| 186 | +Command line options:: | |
| 187 | + | |
| 175 | 188 | arcrimi=<shmem>,<irq>,<node_ID>[,<name>] |
| 176 | 189 | |
| 177 | −If you load the chipset support as a module, the options are: | |
| 190 | +If you load the chipset support as a module, the options are:: | |
| 191 | + | |
| 178 | 192 | shmem=<shmem> irq=<irq> node=<node_ID> device=<name> |
| 179 | 193 | |
| 180 | 194 | |
| 181 | 195 | Loadable Module Support |
| 182 | 196 | ----------------------- |
| 183 | 197 | |
| 184 | −Configure and rebuild Linux. When asked, answer 'm' to "Generic ARCnet | |
| 198 | +Configure and rebuild Linux. When asked, answer 'm' to "Generic ARCnet | |
| 185 | 199 | support" and to support for your ARCnet chipset if you want to use the |
| 186 | −loadable module. You can also say 'y' to "Generic ARCnet support" and 'm' | |
| 200 | +loadable module. You can also say 'y' to "Generic ARCnet support" and 'm' | |
| 187 | 201 | to the chipset support if you wish. |
| 188 | 202 | |
| 203 | +:: | |
| 204 | + | |
| 189 | 205 | make config |
| 190 | − make clean | |
| 206 | + make clean | |
| 191 | 207 | make zImage |
| 192 | 208 | make modules |
| 193 | − | |
| 209 | + | |
| 194 | 210 | If you're using a loadable module, you need to use insmod to load it, and |
| 195 | 211 | you can specify various characteristics of your card on the command |
| 196 | 212 | line. (In recent versions of the driver, autoprobing is much more reliable |
| 197 | 213 | and works as a module, so most of this is now unnecessary.) |
| 198 | 214 | |
| 199 | −For example: | |
| 215 | +For example:: | |
| 216 | + | |
| 200 | 217 | cd /usr/src/linux/modules |
| 201 | 218 | insmod arcnet.o |
| 202 | 219 | insmod com90xx.o |
| 203 | 220 | insmod com20020.o io=0x2e0 device=eth1 |
| 204 | − | |
| 221 | + | |
| 205 | 222 | |
| 206 | 223 | Using the Driver |
| 207 | 224 | ---------------- |
| 208 | 225 | |
| 209 | −If you build your kernel with ARCnet COM90xx support included, it should | |
| 226 | +If you build your kernel with ARCnet COM90xx support included, it should | |
| 210 | 227 | probe for your card automatically when you boot. If you use a different |
| 211 | 228 | chipset driver complied into the kernel, you must give the necessary options |
| 212 | 229 | on the kernel command line, as detailed above. |
| @@ -224,69 +241,78 @@ Multiple Cards in One Computer · 11 unmodified lines | ||
| 224 | 241 | ------------------------------ |
| 225 | 242 | |
| 226 | 243 | Linux has pretty good support for this now, but since I've been busy, the |
| 227 | −ARCnet driver has somewhat suffered in this respect. COM90xx support, if | |
| 228 | −compiled into the kernel, will (try to) autodetect all the installed cards. | |
| 244 | +ARCnet driver has somewhat suffered in this respect. COM90xx support, if | |
| 245 | +compiled into the kernel, will (try to) autodetect all the installed cards. | |
| 246 | + | |
| 247 | +If you have other cards, with support compiled into the kernel, then you can | |
| 248 | +just repeat the options on the kernel command line, e.g.:: | |
| 249 | + | |
| 250 | + LILO: linux com20020=0x2e0 com20020=0x380 com90io=0x260 | |
| 229 | 251 | |
| 230 | −If you have other cards, with support compiled into the kernel, then you can | |
| 231 | −just repeat the options on the kernel command line, e.g.: | |
| 232 | −LILO: linux com20020=0x2e0 com20020=0x380 com90io=0x260 | |
| 252 | +If you have the chipset support built as a loadable module, then you need to | |
| 253 | +do something like this:: | |
| 233 | 254 | |
| 234 | −If you have the chipset support built as a loadable module, then you need to | |
| 235 | −do something like this: | |
| 236 | 255 | insmod -o arc0 com90xx |
| 237 | 256 | insmod -o arc1 com20020 io=0x2e0 |
| 238 | 257 | insmod -o arc2 com90xx |
| 258 | + | |
| 239 | 259 | The ARCnet drivers will now sort out their names automatically. |
| 240 | 260 | |
| 241 | 261 | |
| 242 | 262 | How do I get it to work with...? |
| 243 | 263 | -------------------------------- |
| 244 | 264 | |
| 245 | −NFS: Should be fine linux->linux, just pretend you're using Ethernet cards. | |
| 246 | − oak.oakland.edu:/simtel/msdos/nfs has some nice DOS clients. There | |
| 247 | − is also a DOS-based NFS server called SOSS. It doesn't multitask | |
| 248 | − quite the way Linux does (actually, it doesn't multitask AT ALL) but | |
| 249 | − you never know what you might need. | |
| 250 | − | |
| 251 | − With AmiTCP (and possibly others), you may need to set the following | |
| 252 | − options in your Amiga nfstab: MD 1024 MR 1024 MW 1024 | |
| 253 | − (Thanks to Christian Gottschling <ferksy@indigo.tng.oche.de> | |
| 265 | +NFS: | |
| 266 | + Should be fine linux->linux, just pretend you're using Ethernet cards. | |
| 267 | + oak.oakland.edu:/simtel/msdos/nfs has some nice DOS clients. There | |
| 268 | + is also a DOS-based NFS server called SOSS. It doesn't multitask | |
| 269 | + quite the way Linux does (actually, it doesn't multitask AT ALL) but | |
| 270 | + you never know what you might need. | |
| 271 | + | |
| 272 | + With AmiTCP (and possibly others), you may need to set the following | |
| 273 | + options in your Amiga nfstab: MD 1024 MR 1024 MW 1024 | |
| 274 | + (Thanks to Christian Gottschling <ferksy@indigo.tng.oche.de> | |
| 254 | 275 | for this.) |
| 255 | − | |
| 276 | + | |
| 256 | 277 | Probably these refer to maximum NFS data/read/write block sizes. I |
| 257 | 278 | don't know why the defaults on the Amiga didn't work; write to me if |
| 258 | 279 | you know more. |
| 259 | 280 | |
| 260 | −DOS: If you're using the freeware arcether.com, you might want to install | |
| 261 | − the driver patch from my web page. It helps with PC/TCP, and also | |
| 262 | − can get arcether to load if it timed out too quickly during | |
| 263 | − initialization. In fact, if you use it on a 386+ you REALLY need | |
| 264 | − the patch, really. | |
| 265 | − | |
| 266 | −Windows: See DOS :) Trumpet Winsock works fine with either the Novell or | |
| 281 | +DOS: | |
| 282 | + If you're using the freeware arcether.com, you might want to install | |
| 283 | + the driver patch from my web page. It helps with PC/TCP, and also | |
| 284 | + can get arcether to load if it timed out too quickly during | |
| 285 | + initialization. In fact, if you use it on a 386+ you REALLY need | |
| 286 | + the patch, really. | |
| 287 | + | |
| 288 | +Windows: | |
| 289 | + See DOS :) Trumpet Winsock works fine with either the Novell or | |
| 267 | 290 | Arcether client, assuming you remember to load winpkt of course. |
| 268 | 291 | |
| 269 | −LAN Manager and Windows for Workgroups: These programs use protocols that | |
| 270 | − are incompatible with the Internet standard. They try to pretend | |
| 271 | − the cards are Ethernet, and confuse everyone else on the network. | |
| 272 | − | |
| 273 | − However, v2.00 and higher of the Linux ARCnet driver supports this | |
| 274 | − protocol via the 'arc0e' device. See the section on "Multiprotocol | |
| 275 | − Support" for more information. | |
| 292 | +LAN Manager and Windows for Workgroups: | |
| 293 | + These programs use protocols that | |
| 294 | + are incompatible with the Internet standard. They try to pretend | |
| 295 | + the cards are Ethernet, and confuse everyone else on the network. | |
| 296 | + | |
| 297 | + However, v2.00 and higher of the Linux ARCnet driver supports this | |
| 298 | + protocol via the 'arc0e' device. See the section on "Multiprotocol | |
| 299 | + Support" for more information. | |
| 276 | 300 | |
| 277 | 301 | Using the freeware Samba server and clients for Linux, you can now |
| 278 | 302 | interface quite nicely with TCP/IP-based WfWg or Lan Manager |
| 279 | 303 | networks. |
| 280 | − | |
| 281 | −Windows 95: Tools are included with Win95 that let you use either the LANMAN | |
| 304 | + | |
| 305 | +Windows 95: | |
| 306 | + Tools are included with Win95 that let you use either the LANMAN | |
| 282 | 307 | style network drivers (NDIS) or Novell drivers (ODI) to handle your |
| 283 | 308 | ARCnet packets. If you use ODI, you'll need to use the 'arc0' |
| 284 | − device with Linux. If you use NDIS, then try the 'arc0e' device. | |
| 309 | + device with Linux. If you use NDIS, then try the 'arc0e' device. | |
| 285 | 310 | See the "Multiprotocol Support" section below if you need arc0e, |
| 286 | 311 | you're completely insane, and/or you need to build some kind of |
| 287 | 312 | hybrid network that uses both encapsulation types. |
| 288 | 313 | |
| 289 | −OS/2: I've been told it works under Warp Connect with an ARCnet driver from | |
| 314 | +OS/2: | |
| 315 | + I've been told it works under Warp Connect with an ARCnet driver from | |
| 290 | 316 | SMC. You need to use the 'arc0e' interface for this. If you get |
| 291 | 317 | the SMC driver to work with the TCP/IP stuff included in the |
| 292 | 318 | "normal" Warp Bonus Pack, let me know. |
| @@ -295,7 +321,8 @@ OS/2: I've been told it works under Warp Connect with an ARCnet driver from · 2 unmodified lines | ||
| 295 | 321 | which should use the same protocol as WfWg does. I had no luck |
| 296 | 322 | installing it under Warp, however. Please mail me with any results. |
| 297 | 323 | |
| 298 | −NetBSD/AmiTCP: These use an old version of the Internet standard ARCnet | |
| 324 | +NetBSD/AmiTCP: | |
| 325 | + These use an old version of the Internet standard ARCnet | |
| 299 | 326 | protocol (RFC1051) which is compatible with the Linux driver v2.10 |
| 300 | 327 | ALPHA and above using the arc0s device. (See "Multiprotocol ARCnet" |
| 301 | 328 | below.) ** Newer versions of NetBSD apparently support RFC1201. |
| @@ -307,16 +334,17 @@ Using Multiprotocol ARCnet · 5 unmodified lines | ||
| 307 | 334 | The ARCnet driver v2.10 ALPHA supports three protocols, each on its own |
| 308 | 335 | "virtual network device": |
| 309 | 336 | |
| 310 | − arc0 - RFC1201 protocol, the official Internet standard which just | |
| 311 | − happens to be 100% compatible with Novell's TRXNET driver. | |
| 337 | + ====== =============================================================== | |
| 338 | + arc0 RFC1201 protocol, the official Internet standard which just | |
| 339 | + happens to be 100% compatible with Novell's TRXNET driver. | |
| 312 | 340 | Version 1.00 of the ARCnet driver supported _only_ this |
| 313 | 341 | protocol. arc0 is the fastest of the three protocols (for |
| 314 | 342 | whatever reason), and allows larger packets to be used |
| 315 | − because it supports RFC1201 "packet splitting" operations. | |
| 343 | + because it supports RFC1201 "packet splitting" operations. | |
| 316 | 344 | Unless you have a specific need to use a different protocol, |
| 317 | 345 | I strongly suggest that you stick with this one. |
| 318 | − | |
| 319 | − arc0e - "Ethernet-Encapsulation" which sends packets over ARCnet | |
| 346 | + | |
| 347 | + arc0e "Ethernet-Encapsulation" which sends packets over ARCnet | |
| 320 | 348 | that are actually a lot like Ethernet packets, including the |
| 321 | 349 | 6-byte hardware addresses. This protocol is compatible with |
| 322 | 350 | Microsoft's NDIS ARCnet driver, like the one in WfWg and |
| @@ -328,8 +356,8 @@ The ARCnet driver v2.10 ALPHA supports three protocols, each on its own · 5 unmodified lines | ||
| 328 | 356 | fit. arc0e also works slightly more slowly than arc0, for |
| 329 | 357 | reasons yet to be determined. (Probably it's the smaller |
| 330 | 358 | MTU that does it.) |
| 331 | − | |
| 332 | − arc0s - The "[s]imple" RFC1051 protocol is the "previous" Internet | |
| 359 | + | |
| 360 | + arc0s The "[s]imple" RFC1051 protocol is the "previous" Internet | |
| 333 | 361 | standard that is completely incompatible with the new |
| 334 | 362 | standard. Some software today, however, continues to |
| 335 | 363 | support the old standard (and only the old standard) |
| @@ -338,9 +366,10 @@ The ARCnet driver v2.10 ALPHA supports three protocols, each on its own · 2 unmodified lines | ||
| 338 | 366 | smaller than the Internet "requirement," so it's quite |
| 339 | 367 | possible that you may run into problems. It's also slower |
| 340 | 368 | than RFC1201 by about 25%, for the same reason as arc0e. |
| 341 | − | |
| 369 | + | |
| 342 | 370 | The arc0s support was contributed by Tomasz Motylewski |
| 343 | 371 | and modified somewhat by me. Bugs are probably my fault. |
| 372 | + ====== =============================================================== | |
| 344 | 373 | |
| 345 | 374 | You can choose not to compile arc0e and arc0s into the driver if you want - |
| 346 | 375 | this will save you a bit of memory and avoid confusion when eg. trying to |
| @@ -358,19 +387,21 @@ can set up your network then: · 11 unmodified lines | ||
| 358 | 387 | two available protocols. As mentioned above, it's a good idea to use |
| 359 | 388 | only arc0 unless you have a good reason (like some other software, ie. |
| 360 | 389 | WfWg, that only works with arc0e). |
| 361 | − | |
| 362 | − If you need only arc0, then the following commands should get you going: | |
| 363 | − ifconfig arc0 MY.IP.ADD.RESS | |
| 364 | − route add MY.IP.ADD.RESS arc0 | |
| 365 | − route add -net SUB.NET.ADD.RESS arc0 | |
| 366 | − [add other local routes here] | |
| 367 | − | |
| 368 | − If you need arc0e (and only arc0e), it's a little different: | |
| 369 | − ifconfig arc0 MY.IP.ADD.RESS | |
| 370 | − ifconfig arc0e MY.IP.ADD.RESS | |
| 371 | − route add MY.IP.ADD.RESS arc0e | |
| 372 | − route add -net SUB.NET.ADD.RESS arc0e | |
| 373 | − | |
| 390 | + | |
| 391 | + If you need only arc0, then the following commands should get you going:: | |
| 392 | + | |
| 393 | + ifconfig arc0 MY.IP.ADD.RESS | |
| 394 | + route add MY.IP.ADD.RESS arc0 | |
| 395 | + route add -net SUB.NET.ADD.RESS arc0 | |
| 396 | + [add other local routes here] | |
| 397 | + | |
| 398 | + If you need arc0e (and only arc0e), it's a little different:: | |
| 399 | + | |
| 400 | + ifconfig arc0 MY.IP.ADD.RESS | |
| 401 | + ifconfig arc0e MY.IP.ADD.RESS | |
| 402 | + route add MY.IP.ADD.RESS arc0e | |
| 403 | + route add -net SUB.NET.ADD.RESS arc0e | |
| 404 | + | |
| 374 | 405 | arc0s works much the same way as arc0e. |
| 375 | 406 | |
| 376 | 407 | |
| @@ -391,29 +422,32 @@ can set up your network then: · 14 unmodified lines | ||
| 391 | 422 | XT (patience), however, does not have its own Internet IP address and so |
| 392 | 423 | I assigned it one on a "private subnet" (as defined by RFC1597). |
| 393 | 424 | |
| 394 | − To start with, take a simple network with just insight and freedom. | |
| 425 | + To start with, take a simple network with just insight and freedom. | |
| 395 | 426 | Insight needs to: |
| 396 | − - talk to freedom via RFC1201 (arc0) protocol, because I like it | |
| 427 | + | |
| 428 | + - talk to freedom via RFC1201 (arc0) protocol, because I like it | |
| 397 | 429 | more and it's faster. |
| 398 | 430 | - use freedom as its Internet gateway. |
| 399 | − | |
| 400 | − That's pretty easy to do. Set up insight like this: | |
| 401 | − ifconfig arc0 insight | |
| 402 | − route add insight arc0 | |
| 403 | − route add freedom arc0 /* I would use the subnet here (like I said | |
| 431 | + | |
| 432 | + That's pretty easy to do. Set up insight like this:: | |
| 433 | + | |
| 434 | + ifconfig arc0 insight | |
| 435 | + route add insight arc0 | |
| 436 | + route add freedom arc0 /* I would use the subnet here (like I said | |
| 404 | 437 | to to in "single protocol" above), |
| 405 | − but the rest of the subnet | |
| 406 | − unfortunately lies across the PPP | |
| 407 | − link on freedom, which confuses | |
| 408 | − things. */ | |
| 409 | − route add default gw freedom | |
| 410 | − | |
| 411 | − And freedom gets configured like so: | |
| 412 | − ifconfig arc0 freedom | |
| 413 | − route add freedom arc0 | |
| 414 | − route add insight arc0 | |
| 415 | − /* and default gateway is configured by pppd */ | |
| 416 | − | |
| 438 | + but the rest of the subnet | |
| 439 | + unfortunately lies across the PPP | |
| 440 | + link on freedom, which confuses | |
| 441 | + things. */ | |
| 442 | + route add default gw freedom | |
| 443 | + | |
| 444 | + And freedom gets configured like so:: | |
| 445 | + | |
| 446 | + ifconfig arc0 freedom | |
| 447 | + route add freedom arc0 | |
| 448 | + route add insight arc0 | |
| 449 | + /* and default gateway is configured by pppd */ | |
| 450 | + | |
| 417 | 451 | Great, now insight talks to freedom directly on arc0, and sends packets |
| 418 | 452 | to the Internet through freedom. If you didn't know how to do the above, |
| 419 | 453 | you should probably stop reading this section now because it only gets |
| @@ -425,7 +459,7 @@ can set up your network then: · 5 unmodified lines | ||
| 425 | 459 | Internet. (Recall that patience has a "private IP address" which won't |
| 426 | 460 | work on the Internet; that's okay, I configured Linux IP masquerading on |
| 427 | 461 | freedom for this subnet). |
| 428 | − | |
| 462 | + | |
| 429 | 463 | So patience (necessarily; I don't have another IP number from my |
| 430 | 464 | provider) has an IP address on a different subnet than freedom and |
| 431 | 465 | insight, but needs to use freedom as an Internet gateway. Worse, most |
| @@ -435,53 +469,54 @@ can set up your network then: · 3 unmodified lines | ||
| 435 | 469 | insight, patience WILL send through its default gateway, regardless of |
| 436 | 470 | the fact that both freedom and insight (courtesy of the arc0e device) |
| 437 | 471 | could understand a direct transmission. |
| 438 | − | |
| 439 | − I compensate by giving freedom an extra IP address - aliased 'gatekeeper' | |
| 440 | − - that is on my private subnet, the same subnet that patience is on. I | |
| 472 | + | |
| 473 | + I compensate by giving freedom an extra IP address - aliased 'gatekeeper' - | |
| 474 | + that is on my private subnet, the same subnet that patience is on. I | |
| 441 | 475 | then define gatekeeper to be the default gateway for patience. |
| 442 | − | |
| 443 | − To configure freedom (in addition to the commands above): | |
| 444 | − ifconfig arc0e gatekeeper | |
| 445 | − route add gatekeeper arc0e | |
| 446 | − route add patience arc0e | |
| 447 | − | |
| 476 | + | |
| 477 | + To configure freedom (in addition to the commands above):: | |
| 478 | + | |
| 479 | + ifconfig arc0e gatekeeper | |
| 480 | + route add gatekeeper arc0e | |
| 481 | + route add patience arc0e | |
| 482 | + | |
| 448 | 483 | This way, freedom will send all packets for patience through arc0e, |
| 449 | 484 | giving its IP address as gatekeeper (on the private subnet). When it |
| 450 | 485 | talks to insight or the Internet, it will use its "freedom" Internet IP |
| 451 | 486 | address. |
| 452 | − | |
| 453 | − You will notice that we haven't configured the arc0e device on insight. | |
| 487 | + | |
| 488 | + You will notice that we haven't configured the arc0e device on insight. | |
| 454 | 489 | This would work, but is not really necessary, and would require me to |
| 455 | 490 | assign insight another special IP number from my private subnet. Since |
| 456 | 491 | both insight and patience are using freedom as their default gateway, the |
| 457 | 492 | two can already talk to each other. |
| 458 | − | |
| 493 | + | |
| 459 | 494 | It's quite fortunate that I set things up like this the first time (cough |
| 460 | 495 | cough) because it's really handy when I boot insight into DOS. There, it |
| 461 | − runs the Novell ODI protocol stack, which only works with RFC1201 ARCnet. | |
| 496 | + runs the Novell ODI protocol stack, which only works with RFC1201 ARCnet. | |
| 462 | 497 | In this mode it would be impossible for insight to communicate directly |
| 463 | 498 | with patience, since the Novell stack is incompatible with Microsoft's |
| 464 | 499 | Ethernet-Encap. Without changing any settings on freedom or patience, I |
| 465 | 500 | simply set freedom as the default gateway for insight (now in DOS, |
| 466 | 501 | remember) and all the forwarding happens "automagically" between the two |
| 467 | 502 | hosts that would normally not be able to communicate at all. |
| 468 | − | |
| 503 | + | |
| 469 | 504 | For those who like diagrams, I have created two "virtual subnets" on the |
| 470 | − same physical ARCnet wire. You can picture it like this: | |
| 471 | − | |
| 472 | − | |
| 473 | − [RFC1201 NETWORK] [ETHER-ENCAP NETWORK] | |
| 505 | + same physical ARCnet wire. You can picture it like this:: | |
| 506 | + | |
| 507 | + | |
| 508 | + [RFC1201 NETWORK] [ETHER-ENCAP NETWORK] | |
| 474 | 509 | (registered Internet subnet) (RFC1597 private subnet) |
| 475 | − | |
| 476 | − (IP Masquerade) | |
| 477 | − /---------------\ * /---------------\ | |
| 478 | − | | * | | | |
| 479 | − | +-Freedom-*-Gatekeeper-+ | | |
| 480 | − | | | * | | | |
| 481 | − \-------+-------/ | * \-------+-------/ | |
| 482 | − | | | | |
| 483 | − Insight | Patience | |
| 484 | − (Internet) | |
| 510 | + | |
| 511 | + (IP Masquerade) | |
| 512 | + /---------------\ * /---------------\ | |
| 513 | + | | * | | | |
| 514 | + | +-Freedom-*-Gatekeeper-+ | | |
| 515 | + | | | * | | | |
| 516 | + \-------+-------/ | * \-------+-------/ | |
| 517 | + | | | | |
| 518 | + Insight | Patience | |
| 519 | + (Internet) | |
| 485 | 520 | |
| 486 | 521 | |
| 487 | 522 | |
| @@ -491,6 +526,7 @@ It works: what now? · 3 unmodified lines | ||
| 491 | 526 | Send mail describing your setup, preferably including driver version, kernel |
| 492 | 527 | version, ARCnet card model, CPU type, number of systems on your network, and |
| 493 | 528 | list of software in use to me at the following address: |
| 529 | + | |
| 494 | 530 | apenwarr@worldvisions.ca |
| 495 | 531 | |
| 496 | 532 | I do send (sometimes automated) replies to all messages I receive. My email |
| @@ -525,7 +561,7 @@ this, you should grab the pertinent RFCs. (some are listed near the top of · 28 unmodified lines | ||
| 525 | 561 | arcnet.c). arcdump assumes your card is at 0xD0000. If it isn't, edit the |
| 526 | 562 | script. |
| 527 | 563 | |
| 528 | −Buffers 0 and 1 are used for receiving, and Buffers 2 and 3 are for sending. | |
| 564 | +Buffers 0 and 1 are used for receiving, and Buffers 2 and 3 are for sending. | |
| 529 | 565 | Ping-pong buffers are implemented both ways. |
| 530 | 566 | |
| 531 | 567 | If your debug level includes D_DURING and you did NOT define SLOW_XMIT_COPY, |
| @@ -535,9 +571,11 @@ decides that the driver is broken). During a transmit, unused parts of the · 3 unmodified lines | ||
| 535 | 571 | buffer will be cleared to 0x42 as well. This is to make it easier to figure |
| 536 | 572 | out which bytes are being used by a packet. |
| 537 | 573 | |
| 538 | −You can change the debug level without recompiling the kernel by typing: | |
| 574 | +You can change the debug level without recompiling the kernel by typing:: | |
| 575 | + | |
| 539 | 576 | ifconfig arc0 down metric 1xxx |
| 540 | 577 | /etc/rc.d/rc.inet1 |
| 578 | + | |
| 541 | 579 | where "xxx" is the debug level you want. For example, "metric 1015" would put |
| 542 | 580 | you at debug level 15. Debug level 7 is currently the default. |
| 543 | 581 | |
| @@ -546,7 +584,7 @@ combination of different debug flags; so debug level 7 is really 1+2+4 or · 2 unmodified lines | ||
| 546 | 584 | D_NORMAL+D_EXTRA+D_INIT. To include D_DURING, you would add 16 to this, |
| 547 | 585 | resulting in debug level 23. |
| 548 | 586 | |
| 549 | −If you don't understand that, you probably don't want to know anyway. | |
| 587 | +If you don't understand that, you probably don't want to know anyway. | |
| 550 | 588 | E-mail me about your problem. |
| 551 | 589 | |
| 552 | 590 | |
| @@ -1,3 +1,9 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +=== | |
| 4 | +ATM | |
| 5 | +=== | |
| 6 | + | |
| 1 | 7 | In order to use anything but the most primitive functions of ATM, |
| 2 | 8 | several user-mode programs are required to assist the kernel. These |
| 3 | 9 | programs and related material can be found via the ATM on Linux Web |
| @@ -1,3 +1,9 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +===== | |
| 4 | +AX.25 | |
| 5 | +===== | |
| 6 | + | |
| 1 | 7 | To use the amateur radio protocols within Linux you will need to get a |
| 2 | 8 | suitable copy of the AX.25 Utilities. More detailed information about |
| 3 | 9 | AX.25, NET/ROM and ROSE, associated programs and and utilities can be |
| @@ -1,26 +1,31 @@ | ||
| 1 | − LINUX DRIVERS FOR BAYCOM MODEMS | |
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | 2 | |
| 3 | − Thomas M. Sailer, HB9JNX/AE4WA, <sailer@ife.ee.ethz.ch> | |
| 3 | +=============================== | |
| 4 | +Linux Drivers for Baycom Modems | |
| 5 | +=============================== | |
| 4 | 6 | |
| 5 | −!!NEW!! (04/98) The drivers for the baycom modems have been split into | |
| 7 | +Thomas M. Sailer, HB9JNX/AE4WA, <sailer@ife.ee.ethz.ch> | |
| 8 | + | |
| 9 | +The drivers for the baycom modems have been split into | |
| 6 | 10 | separate drivers as they did not share any code, and the driver |
| 7 | 11 | and device names have changed. |
| 8 | 12 | |
| 9 | 13 | This document describes the Linux Kernel Drivers for simple Baycom style |
| 10 | −amateur radio modems. | |
| 14 | +amateur radio modems. | |
| 11 | 15 | |
| 12 | 16 | The following drivers are available: |
| 17 | +==================================== | |
| 13 | 18 | |
| 14 | 19 | baycom_ser_fdx: |
| 15 | 20 | This driver supports the SER12 modems either full or half duplex. |
| 16 | − Its baud rate may be changed via the `baud' module parameter, | |
| 21 | + Its baud rate may be changed via the ``baud`` module parameter, | |
| 17 | 22 | therefore it supports just about every bit bang modem on a |
| 18 | 23 | serial port. Its devices are called bcsf0 through bcsf3. |
| 19 | 24 | This is the recommended driver for SER12 type modems, |
| 20 | 25 | however if you have a broken UART clone that does not have working |
| 21 | − delta status bits, you may try baycom_ser_hdx. | |
| 26 | + delta status bits, you may try baycom_ser_hdx. | |
| 22 | 27 | |
| 23 | −baycom_ser_hdx: | |
| 28 | +baycom_ser_hdx: | |
| 24 | 29 | This is an alternative driver for SER12 type modems. |
| 25 | 30 | It only supports half duplex, and only 1200 baud. Its devices |
| 26 | 31 | are called bcsh0 through bcsh3. Use this driver only if baycom_ser_fdx |
| @@ -37,45 +42,48 @@ baycom_epp: · 10 unmodified lines | ||
| 37 | 42 | |
| 38 | 43 | The following modems are supported: |
| 39 | 44 | |
| 40 | −ser12: This is a very simple 1200 baud AFSK modem. The modem consists only | |
| 41 | − of a modulator/demodulator chip, usually a TI TCM3105. The computer | |
| 42 | − is responsible for regenerating the receiver bit clock, as well as | |
| 43 | − for handling the HDLC protocol. The modem connects to a serial port, | |
| 44 | − hence the name. Since the serial port is not used as an async serial | |
| 45 | − port, the kernel driver for serial ports cannot be used, and this | |
| 46 | − driver only supports standard serial hardware (8250, 16450, 16550) | |
| 47 | − | |
| 48 | −par96: This is a modem for 9600 baud FSK compatible to the G3RUH standard. | |
| 49 | − The modem does all the filtering and regenerates the receiver clock. | |
| 50 | − Data is transferred from and to the PC via a shift register. | |
| 51 | − The shift register is filled with 16 bits and an interrupt is signalled. | |
| 52 | − The PC then empties the shift register in a burst. This modem connects | |
| 53 | − to the parallel port, hence the name. The modem leaves the | |
| 54 | − implementation of the HDLC protocol and the scrambler polynomial to | |
| 55 | − the PC. | |
| 56 | − | |
| 57 | −picpar: This is a redesign of the par96 modem by Henning Rech, DF9IC. The modem | |
| 58 | − is protocol compatible to par96, but uses only three low power ICs | |
| 59 | − and can therefore be fed from the parallel port and does not require | |
| 60 | − an additional power supply. Furthermore, it incorporates a carrier | |
| 61 | − detect circuitry. | |
| 62 | − | |
| 63 | −EPP: This is a high-speed modem adaptor that connects to an enhanced parallel port. | |
| 64 | − Its target audience is users working over a high speed hub (76.8kbit/s). | |
| 65 | − | |
| 66 | −eppfpga: This is a redesign of the EPP adaptor. | |
| 67 | − | |
| 68 | − | |
| 45 | +======= ======================================================================== | |
| 46 | +ser12 This is a very simple 1200 baud AFSK modem. The modem consists only | |
| 47 | + of a modulator/demodulator chip, usually a TI TCM3105. The computer | |
| 48 | + is responsible for regenerating the receiver bit clock, as well as | |
| 49 | + for handling the HDLC protocol. The modem connects to a serial port, | |
| 50 | + hence the name. Since the serial port is not used as an async serial | |
| 51 | + port, the kernel driver for serial ports cannot be used, and this | |
| 52 | + driver only supports standard serial hardware (8250, 16450, 16550) | |
| 53 | + | |
| 54 | +par96 This is a modem for 9600 baud FSK compatible to the G3RUH standard. | |
| 55 | + The modem does all the filtering and regenerates the receiver clock. | |
| 56 | + Data is transferred from and to the PC via a shift register. | |
| 57 | + The shift register is filled with 16 bits and an interrupt is signalled. | |
| 58 | + The PC then empties the shift register in a burst. This modem connects | |
| 59 | + to the parallel port, hence the name. The modem leaves the | |
| 60 | + implementation of the HDLC protocol and the scrambler polynomial to | |
| 61 | + the PC. | |
| 62 | + | |
| 63 | +picpar This is a redesign of the par96 modem by Henning Rech, DF9IC. The modem | |
| 64 | + is protocol compatible to par96, but uses only three low power ICs | |
| 65 | + and can therefore be fed from the parallel port and does not require | |
| 66 | + an additional power supply. Furthermore, it incorporates a carrier | |
| 67 | + detect circuitry. | |
| 68 | + | |
| 69 | +EPP This is a high-speed modem adaptor that connects to an enhanced parallel | |
| 70 | + port. | |
| 71 | + | |
| 72 | + Its target audience is users working over a high speed hub (76.8kbit/s). | |
| 73 | + | |
| 74 | +eppfpga This is a redesign of the EPP adaptor. | |
| 75 | +======= ======================================================================== | |
| 69 | 76 | |
| 70 | 77 | All of the above modems only support half duplex communications. However, |
| 71 | 78 | the driver supports the KISS (see below) fullduplex command. It then simply |
| 72 | 79 | starts to send as soon as there's a packet to transmit and does not care |
| 73 | 80 | about DCD, i.e. it starts to send even if there's someone else on the channel. |
| 74 | −This command is required by some implementations of the DAMA channel | |
| 81 | +This command is required by some implementations of the DAMA channel | |
| 75 | 82 | access protocol. |
| 76 | 83 | |
| 77 | 84 | |
| 78 | 85 | The Interface of the drivers |
| 86 | +============================ | |
| 79 | 87 | |
| 80 | 88 | Unlike previous drivers, these drivers are no longer character devices, |
| 81 | 89 | but they are now true kernel network interfaces. Installation is therefore |
| @@ -88,20 +96,22 @@ me for WAMPES which allows attaching a kernel network interface directly. · 6 unmodified lines | ||
| 88 | 96 | |
| 89 | 97 | |
| 90 | 98 | Configuring the driver |
| 99 | +====================== | |
| 91 | 100 | |
| 92 | 101 | Every time a driver is inserted into the kernel, it has to know which |
| 93 | 102 | modems it should access at which ports. This can be done with the setbaycom |
| 94 | 103 | utility. If you are only using one modem, you can also configure the |
| 95 | 104 | driver from the insmod command line (or by means of an option line in |
| 96 | −/etc/modprobe.d/*.conf). | |
| 105 | +``/etc/modprobe.d/*.conf``). | |
| 106 | + | |
| 107 | +Examples:: | |
| 97 | 108 | |
| 98 | −Examples: | |
| 99 | 109 | modprobe baycom_ser_fdx mode="ser12*" iobase=0x3f8 irq=4 |
| 100 | 110 | sethdlc -i bcsf0 -p mode "ser12*" io 0x3f8 irq 4 |
| 101 | 111 | |
| 102 | 112 | Both lines configure the first port to drive a ser12 modem at the first |
| 103 | −serial port (COM1 under DOS). The * in the mode parameter instructs the driver to use | |
| 104 | −the software DCD algorithm (see below). | |
| 113 | +serial port (COM1 under DOS). The * in the mode parameter instructs the driver | |
| 114 | +to use the software DCD algorithm (see below):: | |
| 105 | 115 | |
| 106 | 116 | insmod baycom_par mode="picpar" iobase=0x378 |
| 107 | 117 | sethdlc -i bcp0 -p mode "picpar" io 0x378 |
| @@ -115,29 +125,33 @@ Note that both utilities interpret the values slightly differently. · 7 unmodified lines | ||
| 115 | 125 | |
| 116 | 126 | |
| 117 | 127 | Hardware DCD versus Software DCD |
| 128 | +================================ | |
| 118 | 129 | |
| 119 | 130 | To avoid collisions on the air, the driver must know when the channel is |
| 120 | 131 | busy. This is the task of the DCD circuitry/software. The driver may either |
| 121 | 132 | utilise a software DCD algorithm (options=1) or use a DCD signal from |
| 122 | 133 | the hardware (options=0). |
| 123 | 134 | |
| 124 | −ser12: if software DCD is utilised, the radio's squelch should always be | |
| 125 | − open. It is highly recommended to use the software DCD algorithm, | |
| 126 | − as it is much faster than most hardware squelch circuitry. The | |
| 127 | − disadvantage is a slightly higher load on the system. | |
| 135 | +======= ================================================================= | |
| 136 | +ser12 if software DCD is utilised, the radio's squelch should always be | |
| 137 | + open. It is highly recommended to use the software DCD algorithm, | |
| 138 | + as it is much faster than most hardware squelch circuitry. The | |
| 139 | + disadvantage is a slightly higher load on the system. | |
| 128 | 140 | |
| 129 | −par96: the software DCD algorithm for this type of modem is rather poor. | |
| 130 | − The modem simply does not provide enough information to implement | |
| 131 | − a reasonable DCD algorithm in software. Therefore, if your radio | |
| 132 | − feeds the DCD input of the PAR96 modem, the use of the hardware | |
| 133 | − DCD circuitry is recommended. | |
| 141 | +par96 the software DCD algorithm for this type of modem is rather poor. | |
| 142 | + The modem simply does not provide enough information to implement | |
| 143 | + a reasonable DCD algorithm in software. Therefore, if your radio | |
| 144 | + feeds the DCD input of the PAR96 modem, the use of the hardware | |
| 145 | + DCD circuitry is recommended. | |
| 134 | 146 | |
| 135 | −picpar: the picpar modem features a builtin DCD hardware, which is highly | |
| 136 | − recommended. | |
| 147 | +picpar the picpar modem features a builtin DCD hardware, which is highly | |
| 148 | + recommended. | |
| 149 | +======= ================================================================= | |
| 137 | 150 | |
| 138 | 151 | |
| 139 | 152 | |
| 140 | 153 | Compatibility with the rest of the Linux kernel |
| 154 | +=============================================== | |
| 141 | 155 | |
| 142 | 156 | The serial driver and the baycom serial drivers compete |
| 143 | 157 | for the same hardware resources. Of course only one driver can access a given |
| @@ -154,5 +168,7 @@ The parallel port drivers (baycom_par, baycom_epp) now use the parport subsystem · 10 unmodified lines | ||
| 154 | 168 | to arbitrate the ports between different client drivers. |
| 155 | 169 | |
| 156 | 170 | vy 73s de |
| 171 | + | |
| 157 | 172 | Tom Sailer, sailer@ife.ee.ethz.ch |
| 173 | + | |
| 158 | 174 | hb9jnx @ hb9w.ampr.org |
| @@ -1,10 +1,15 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 1 | 2 | |
| 2 | − Linux Ethernet Bonding Driver HOWTO | |
| 3 | +=================================== | |
| 4 | +Linux Ethernet Bonding Driver HOWTO | |
| 5 | +=================================== | |
| 3 | 6 | |
| 4 | − Latest update: 27 April 2011 | |
| 7 | +Latest update: 27 April 2011 | |
| 8 | + | |
| 9 | +Initial release: Thomas Davis <tadavis at lbl.gov> | |
| 10 | + | |
| 11 | +Corrections, HA extensions: 2000/10/03-15: | |
| 5 | 12 | |
| 6 | −Initial release : Thomas Davis <tadavis at lbl.gov> | |
| 7 | −Corrections, HA extensions : 2000/10/03-15 : | |
| 8 | 13 | - Willy Tarreau <willy at meta-x.org> |
| 9 | 14 | - Constantine Gavrilov <const-g at xpert.com> |
| 10 | 15 | - Chad N. Tindel <ctindel at ieee dot org> |
| @@ -13,98 +18,98 @@ Corrections, HA extensions : 2000/10/03-15 : · 2 unmodified lines | ||
| 13 | 18 | |
| 14 | 19 | Reorganized and updated Feb 2005 by Jay Vosburgh |
| 15 | 20 | Added Sysfs information: 2006/04/24 |
| 21 | + | |
| 16 | 22 | - Mitch Williams <mitch.a.williams at intel.com> |
| 17 | 23 | |
| 18 | 24 | Introduction |
| 19 | 25 | ============ |
| 20 | 26 | |
| 21 | − The Linux bonding driver provides a method for aggregating | |
| 27 | +The Linux bonding driver provides a method for aggregating | |
| 22 | 28 | multiple network interfaces into a single logical "bonded" interface. |
| 23 | 29 | The behavior of the bonded interfaces depends upon the mode; generally |
| 24 | 30 | speaking, modes provide either hot standby or load balancing services. |
| 25 | 31 | Additionally, link integrity monitoring may be performed. |
| 26 | − | |
| 27 | − The bonding driver originally came from Donald Becker's | |
| 32 | + | |
| 33 | +The bonding driver originally came from Donald Becker's | |
| 28 | 34 | beowulf patches for kernel 2.0. It has changed quite a bit since, and |
| 29 | 35 | the original tools from extreme-linux and beowulf sites will not work |
| 30 | 36 | with this version of the driver. |
| 31 | 37 | |
| 32 | − For new versions of the driver, updated userspace tools, and | |
| 38 | +For new versions of the driver, updated userspace tools, and | |
| 33 | 39 | who to ask for help, please follow the links at the end of this file. |
| 34 | 40 | |
| 35 | −Table of Contents | |
| 36 | −================= | |
| 41 | +.. Table of Contents | |
| 37 | 42 | |
| 38 | −1. Bonding Driver Installation | |
| 43 | + 1. Bonding Driver Installation | |
| 39 | 44 | |
| 40 | −2. Bonding Driver Options | |
| 45 | + 2. Bonding Driver Options | |
| 41 | 46 | |
| 42 | −3. Configuring Bonding Devices | |
| 43 | −3.1 Configuration with Sysconfig Support | |
| 44 | −3.1.1 Using DHCP with Sysconfig | |
| 45 | −3.1.2 Configuring Multiple Bonds with Sysconfig | |
| 46 | −3.2 Configuration with Initscripts Support | |
| 47 | −3.2.1 Using DHCP with Initscripts | |
| 48 | −3.2.2 Configuring Multiple Bonds with Initscripts | |
| 49 | −3.3 Configuring Bonding Manually with Ifenslave | |
| 50 | −3.3.1 Configuring Multiple Bonds Manually | |
| 51 | −3.4 Configuring Bonding Manually via Sysfs | |
| 52 | −3.5 Configuration with Interfaces Support | |
| 53 | −3.6 Overriding Configuration for Special Cases | |
| 54 | −3.7 Configuring LACP for 802.3ad mode in a more secure way | |
| 47 | + 3. Configuring Bonding Devices | |
| 48 | + 3.1 Configuration with Sysconfig Support | |
| 49 | + 3.1.1 Using DHCP with Sysconfig | |
| 50 | + 3.1.2 Configuring Multiple Bonds with Sysconfig | |
| 51 | + 3.2 Configuration with Initscripts Support | |
| 52 | + 3.2.1 Using DHCP with Initscripts | |
| 53 | + 3.2.2 Configuring Multiple Bonds with Initscripts | |
| 54 | + 3.3 Configuring Bonding Manually with Ifenslave | |
| 55 | + 3.3.1 Configuring Multiple Bonds Manually | |
| 56 | + 3.4 Configuring Bonding Manually via Sysfs | |
| 57 | + 3.5 Configuration with Interfaces Support | |
| 58 | + 3.6 Overriding Configuration for Special Cases | |
| 59 | + 3.7 Configuring LACP for 802.3ad mode in a more secure way | |
| 55 | 60 | |
| 56 | −4. Querying Bonding Configuration | |
| 57 | −4.1 Bonding Configuration | |
| 58 | −4.2 Network Configuration | |
| 61 | + 4. Querying Bonding Configuration | |
| 62 | + 4.1 Bonding Configuration | |
| 63 | + 4.2 Network Configuration | |
| 59 | 64 | |
| 60 | −5. Switch Configuration | |
| 65 | + 5. Switch Configuration | |
| 61 | 66 | |
| 62 | −6. 802.1q VLAN Support | |
| 67 | + 6. 802.1q VLAN Support | |
| 63 | 68 | |
| 64 | −7. Link Monitoring | |
| 65 | −7.1 ARP Monitor Operation | |
| 66 | −7.2 Configuring Multiple ARP Targets | |
| 67 | −7.3 MII Monitor Operation | |
| 69 | + 7. Link Monitoring | |
| 70 | + 7.1 ARP Monitor Operation | |
| 71 | + 7.2 Configuring Multiple ARP Targets | |
| 72 | + 7.3 MII Monitor Operation | |
| 68 | 73 | |
| 69 | −8. Potential Trouble Sources | |
| 70 | −8.1 Adventures in Routing | |
| 71 | −8.2 Ethernet Device Renaming | |
| 72 | −8.3 Painfully Slow Or No Failed Link Detection By Miimon | |
| 74 | + 8. Potential Trouble Sources | |
| 75 | + 8.1 Adventures in Routing | |
| 76 | + 8.2 Ethernet Device Renaming | |
| 77 | + 8.3 Painfully Slow Or No Failed Link Detection By Miimon | |
| 73 | 78 | |
| 74 | −9. SNMP agents | |
| 79 | + 9. SNMP agents | |
| 75 | 80 | |
| 76 | −10. Promiscuous mode | |
| 81 | + 10. Promiscuous mode | |
| 77 | 82 | |
| 78 | −11. Configuring Bonding for High Availability | |
| 79 | −11.1 High Availability in a Single Switch Topology | |
| 80 | −11.2 High Availability in a Multiple Switch Topology | |
| 81 | −11.2.1 HA Bonding Mode Selection for Multiple Switch Topology | |
| 82 | −11.2.2 HA Link Monitoring for Multiple Switch Topology | |
| 83 | + 11. Configuring Bonding for High Availability | |
| 84 | + 11.1 High Availability in a Single Switch Topology | |
| 85 | + 11.2 High Availability in a Multiple Switch Topology | |
| 86 | + 11.2.1 HA Bonding Mode Selection for Multiple Switch Topology | |
| 87 | + 11.2.2 HA Link Monitoring for Multiple Switch Topology | |
| 83 | 88 | |
| 84 | −12. Configuring Bonding for Maximum Throughput | |
| 85 | −12.1 Maximum Throughput in a Single Switch Topology | |
| 86 | −12.1.1 MT Bonding Mode Selection for Single Switch Topology | |
| 87 | −12.1.2 MT Link Monitoring for Single Switch Topology | |
| 88 | −12.2 Maximum Throughput in a Multiple Switch Topology | |
| 89 | −12.2.1 MT Bonding Mode Selection for Multiple Switch Topology | |
| 90 | −12.2.2 MT Link Monitoring for Multiple Switch Topology | |
| 89 | + 12. Configuring Bonding for Maximum Throughput | |
| 90 | + 12.1 Maximum Throughput in a Single Switch Topology | |
| 91 | + 12.1.1 MT Bonding Mode Selection for Single Switch Topology | |
| 92 | + 12.1.2 MT Link Monitoring for Single Switch Topology | |
| 93 | + 12.2 Maximum Throughput in a Multiple Switch Topology | |
| 94 | + 12.2.1 MT Bonding Mode Selection for Multiple Switch Topology | |
| 95 | + 12.2.2 MT Link Monitoring for Multiple Switch Topology | |
| 91 | 96 | |
| 92 | −13. Switch Behavior Issues | |
| 93 | −13.1 Link Establishment and Failover Delays | |
| 94 | −13.2 Duplicated Incoming Packets | |
| 97 | + 13. Switch Behavior Issues | |
| 98 | + 13.1 Link Establishment and Failover Delays | |
| 99 | + 13.2 Duplicated Incoming Packets | |
| 95 | 100 | |
| 96 | −14. Hardware Specific Considerations | |
| 97 | −14.1 IBM BladeCenter | |
| 101 | + 14. Hardware Specific Considerations | |
| 102 | + 14.1 IBM BladeCenter | |
| 98 | 103 | |
| 99 | −15. Frequently Asked Questions | |
| 104 | + 15. Frequently Asked Questions | |
| 100 | 105 | |
| 101 | −16. Resources and Links | |
| 106 | + 16. Resources and Links | |
| 102 | 107 | |
| 103 | 108 | |
| 104 | 109 | 1. Bonding Driver Installation |
| 105 | 110 | ============================== |
| 106 | 111 | |
| 107 | − Most popular distro kernels ship with the bonding driver | |
| 112 | +Most popular distro kernels ship with the bonding driver | |
| 108 | 113 | already available as a module. If your distro does not, or you |
| 109 | 114 | have need to compile bonding from source (e.g., configuring and |
| 110 | 115 | installing a mainline kernel from kernel.org), you'll need to perform |
| @@ -113,54 +118,54 @@ the following steps: · 2 unmodified lines | ||
| 113 | 118 | 1.1 Configure and build the kernel with bonding |
| 114 | 119 | ----------------------------------------------- |
| 115 | 120 | |
| 116 | − The current version of the bonding driver is available in the | |
| 121 | +The current version of the bonding driver is available in the | |
| 117 | 122 | drivers/net/bonding subdirectory of the most recent kernel source |
| 118 | 123 | (which is available on http://kernel.org). Most users "rolling their |
| 119 | 124 | own" will want to use the most recent kernel from kernel.org. |
| 120 | 125 | |
| 121 | − Configure kernel with "make menuconfig" (or "make xconfig" or | |
| 126 | +Configure kernel with "make menuconfig" (or "make xconfig" or | |
| 122 | 127 | "make config"), then select "Bonding driver support" in the "Network |
| 123 | 128 | device support" section. It is recommended that you configure the |
| 124 | 129 | driver as module since it is currently the only way to pass parameters |
| 125 | 130 | to the driver or configure more than one bonding device. |
| 126 | 131 | |
| 127 | − Build and install the new kernel and modules. | |
| 132 | +Build and install the new kernel and modules. | |
| 128 | 133 | |
| 129 | 134 | 1.2 Bonding Control Utility |
| 130 | −------------------------------------- | |
| 135 | +--------------------------- | |
| 131 | 136 | |
| 132 | − It is recommended to configure bonding via iproute2 (netlink) | |
| 137 | +It is recommended to configure bonding via iproute2 (netlink) | |
| 133 | 138 | or sysfs, the old ifenslave control utility is obsolete. |
| 134 | 139 | |
| 135 | 140 | 2. Bonding Driver Options |
| 136 | 141 | ========================= |
| 137 | 142 | |
| 138 | − Options for the bonding driver are supplied as parameters to the | |
| 143 | +Options for the bonding driver are supplied as parameters to the | |
| 139 | 144 | bonding module at load time, or are specified via sysfs. |
| 140 | 145 | |
| 141 | − Module options may be given as command line arguments to the | |
| 146 | +Module options may be given as command line arguments to the | |
| 142 | 147 | insmod or modprobe command, but are usually specified in either the |
| 143 | −/etc/modprobe.d/*.conf configuration files, or in a distro-specific | |
| 148 | +``/etc/modprobe.d/*.conf`` configuration files, or in a distro-specific | |
| 144 | 149 | configuration file (some of which are detailed in the next section). |
| 145 | 150 | |
| 146 | − Details on bonding support for sysfs is provided in the | |
| 151 | +Details on bonding support for sysfs is provided in the | |
| 147 | 152 | "Configuring Bonding Manually via Sysfs" section, below. |
| 148 | 153 | |
| 149 | − The available bonding driver parameters are listed below. If a | |
| 154 | +The available bonding driver parameters are listed below. If a | |
| 150 | 155 | parameter is not specified the default value is used. When initially |
| 151 | 156 | configuring a bond, it is recommended "tail -f /var/log/messages" be |
| 152 | 157 | run in a separate window to watch for bonding driver error messages. |
| 153 | 158 | |
| 154 | − It is critical that either the miimon or arp_interval and | |
| 159 | +It is critical that either the miimon or arp_interval and | |
| 155 | 160 | arp_ip_target parameters be specified, otherwise serious network |
| 156 | 161 | degradation will occur during link failures. Very few devices do not |
| 157 | 162 | support at least miimon, so there is really no reason not to use it. |
| 158 | 163 | |
| 159 | − Options with textual values will accept either the text name | |
| 164 | +Options with textual values will accept either the text name | |
| 160 | 165 | or, for backwards compatibility, the option value. E.g., |
| 161 | 166 | "mode=802.3ad" and "mode=4" set the same mode. |
| 162 | 167 | |
| 163 | − The parameters are as follows: | |
| 168 | +The parameters are as follows: | |
| 164 | 169 | |
| 165 | 170 | active_slave |
| 166 | 171 | |
| @@ -246,10 +251,13 @@ ad_user_port_key · 79 unmodified lines | ||
| 246 | 251 | |
| 247 | 252 | In an AD system, the port-key has three parts as shown below - |
| 248 | 253 | |
| 254 | + ===== ============ | |
| 249 | 255 | Bits Use |
| 256 | + ===== ============ | |
| 250 | 257 | 00 Duplex |
| 251 | 258 | 01-05 Speed |
| 252 | 259 | 06-15 User-defined |
| 260 | + ===== ============ | |
| 253 | 261 | |
| 254 | 262 | This defines the upper 10 bits of the port key. The values can be |
| 255 | 263 | from 0 - 1023. If not given, the system defaults to 0. |
| @@ -699,7 +707,7 @@ mode · 443 unmodified lines | ||
| 699 | 707 | swapped with the new curr_active_slave that was |
| 700 | 708 | chosen. |
| 701 | 709 | |
| 702 | −num_grat_arp | |
| 710 | +num_grat_arp, | |
| 703 | 711 | num_unsol_na |
| 704 | 712 | |
| 705 | 713 | Specify the number of peer notifications (gratuitous ARPs and |
| @@ -729,13 +737,13 @@ packets_per_slave · 23 unmodified lines | ||
| 729 | 737 | |
| 730 | 738 | peer_notif_delay |
| 731 | 739 | |
| 732 | − Specify the delay, in milliseconds, between each peer | |
| 733 | − notification (gratuitous ARP and unsolicited IPv6 Neighbor | |
| 734 | − Advertisement) when they are issued after a failover event. | |
| 735 | − This delay should be a multiple of the link monitor interval | |
| 736 | − (arp_interval or miimon, whichever is active). The default | |
| 737 | − value is 0 which means to match the value of the link monitor | |
| 738 | − interval. | |
| 740 | + Specify the delay, in milliseconds, between each peer | |
| 741 | + notification (gratuitous ARP and unsolicited IPv6 Neighbor | |
| 742 | + Advertisement) when they are issued after a failover event. | |
| 743 | + This delay should be a multiple of the link monitor interval | |
| 744 | + (arp_interval or miimon, whichever is active). The default | |
| 745 | + value is 0 which means to match the value of the link monitor | |
| 746 | + interval. | |
| 739 | 747 | |
| 740 | 748 | primary |
| 741 | 749 | |
| @@ -977,88 +985,88 @@ lp_interval · 235 unmodified lines | ||
| 977 | 985 | 3. Configuring Bonding Devices |
| 978 | 986 | ============================== |
| 979 | 987 | |
| 980 | − You can configure bonding using either your distro's network | |
| 988 | +You can configure bonding using either your distro's network | |
| 981 | 989 | initialization scripts, or manually using either iproute2 or the |
| 982 | 990 | sysfs interface. Distros generally use one of three packages for the |
| 983 | 991 | network initialization scripts: initscripts, sysconfig or interfaces. |
| 984 | 992 | Recent versions of these packages have support for bonding, while older |
| 985 | 993 | versions do not. |
| 986 | 994 | |
| 987 | − We will first describe the options for configuring bonding for | |
| 995 | +We will first describe the options for configuring bonding for | |
| 988 | 996 | distros using versions of initscripts, sysconfig and interfaces with full |
| 989 | 997 | or partial support for bonding, then provide information on enabling |
| 990 | 998 | bonding without support from the network initialization scripts (i.e., |
| 991 | 999 | older versions of initscripts or sysconfig). |
| 992 | 1000 | |
| 993 | − If you're unsure whether your distro uses sysconfig, | |
| 1001 | +If you're unsure whether your distro uses sysconfig, | |
| 994 | 1002 | initscripts or interfaces, or don't know if it's new enough, have no fear. |
| 995 | 1003 | Determining this is fairly straightforward. |
| 996 | 1004 | |
| 997 | − First, look for a file called interfaces in /etc/network directory. | |
| 1005 | +First, look for a file called interfaces in /etc/network directory. | |
| 998 | 1006 | If this file is present in your system, then your system use interfaces. See |
| 999 | 1007 | Configuration with Interfaces Support. |
| 1000 | 1008 | |
| 1001 | − Else, issue the command: | |
| 1009 | +Else, issue the command:: | |
| 1002 | 1010 | |
| 1003 | −$ rpm -qf /sbin/ifup | |
| 1011 | + $ rpm -qf /sbin/ifup | |
| 1004 | 1012 | |
| 1005 | − It will respond with a line of text starting with either | |
| 1013 | +It will respond with a line of text starting with either | |
| 1006 | 1014 | "initscripts" or "sysconfig," followed by some numbers. This is the |
| 1007 | 1015 | package that provides your network initialization scripts. |
| 1008 | 1016 | |
| 1009 | − Next, to determine if your installation supports bonding, | |
| 1010 | −issue the command: | |
| 1017 | +Next, to determine if your installation supports bonding, | |
| 1018 | +issue the command:: | |
| 1011 | 1019 | |
| 1012 | −$ grep ifenslave /sbin/ifup | |
| 1020 | + $ grep ifenslave /sbin/ifup | |
| 1013 | 1021 | |
| 1014 | − If this returns any matches, then your initscripts or | |
| 1022 | +If this returns any matches, then your initscripts or | |
| 1015 | 1023 | sysconfig has support for bonding. |
| 1016 | 1024 | |
| 1017 | 1025 | 3.1 Configuration with Sysconfig Support |
| 1018 | 1026 | ---------------------------------------- |
| 1019 | 1027 | |
| 1020 | − This section applies to distros using a version of sysconfig | |
| 1028 | +This section applies to distros using a version of sysconfig | |
| 1021 | 1029 | with bonding support, for example, SuSE Linux Enterprise Server 9. |
| 1022 | 1030 | |
| 1023 | − SuSE SLES 9's networking configuration system does support | |
| 1031 | +SuSE SLES 9's networking configuration system does support | |
| 1024 | 1032 | bonding, however, at this writing, the YaST system configuration |
| 1025 | 1033 | front end does not provide any means to work with bonding devices. |
| 1026 | 1034 | Bonding devices can be managed by hand, however, as follows. |
| 1027 | 1035 | |
| 1028 | − First, if they have not already been configured, configure the | |
| 1036 | +First, if they have not already been configured, configure the | |
| 1029 | 1037 | slave devices. On SLES 9, this is most easily done by running the |
| 1030 | 1038 | yast2 sysconfig configuration utility. The goal is for to create an |
| 1031 | 1039 | ifcfg-id file for each slave device. The simplest way to accomplish |
| 1032 | 1040 | this is to configure the devices for DHCP (this is only to get the |
| 1033 | 1041 | file ifcfg-id file created; see below for some issues with DHCP). The |
| 1034 | −name of the configuration file for each device will be of the form: | |
| 1042 | +name of the configuration file for each device will be of the form:: | |
| 1035 | 1043 | |
| 1036 | −ifcfg-id-xx:xx:xx:xx:xx:xx | |
| 1044 | + ifcfg-id-xx:xx:xx:xx:xx:xx | |
| 1037 | 1045 | |
| 1038 | − Where the "xx" portion will be replaced with the digits from | |
| 1046 | +Where the "xx" portion will be replaced with the digits from | |
| 1039 | 1047 | the device's permanent MAC address. |
| 1040 | 1048 | |
| 1041 | − Once the set of ifcfg-id-xx:xx:xx:xx:xx:xx files has been | |
| 1049 | +Once the set of ifcfg-id-xx:xx:xx:xx:xx:xx files has been | |
| 1042 | 1050 | created, it is necessary to edit the configuration files for the slave |
| 1043 | 1051 | devices (the MAC addresses correspond to those of the slave devices). |
| 1044 | 1052 | Before editing, the file will contain multiple lines, and will look |
| 1045 | −something like this: | |
| 1053 | +something like this:: | |
| 1046 | 1054 | |
| 1047 | −BOOTPROTO='dhcp' | |
| 1048 | −STARTMODE='on' | |
| 1049 | −USERCTL='no' | |
| 1050 | −UNIQUE='XNzu.WeZGOGF+4wE' | |
| 1051 | −_nm_name='bus-pci-0001:61:01.0' | |
| 1055 | + BOOTPROTO='dhcp' | |
| 1056 | + STARTMODE='on' | |
| 1057 | + USERCTL='no' | |
| 1058 | + UNIQUE='XNzu.WeZGOGF+4wE' | |
| 1059 | + _nm_name='bus-pci-0001:61:01.0' | |
| 1052 | 1060 | |
| 1053 | − Change the BOOTPROTO and STARTMODE lines to the following: | |
| 1061 | +Change the BOOTPROTO and STARTMODE lines to the following:: | |
| 1054 | 1062 | |
| 1055 | −BOOTPROTO='none' | |
| 1056 | −STARTMODE='off' | |
| 1063 | + BOOTPROTO='none' | |
| 1064 | + STARTMODE='off' | |
| 1057 | 1065 | |
| 1058 | − Do not alter the UNIQUE or _nm_name lines. Remove any other | |
| 1066 | +Do not alter the UNIQUE or _nm_name lines. Remove any other | |
| 1059 | 1067 | lines (USERCTL, etc). |
| 1060 | 1068 | |
| 1061 | − Once the ifcfg-id-xx:xx:xx:xx:xx:xx files have been modified, | |
| 1069 | +Once the ifcfg-id-xx:xx:xx:xx:xx:xx files have been modified, | |
| 1062 | 1070 | it's time to create the configuration file for the bonding device |
| 1063 | 1071 | itself. This file is named ifcfg-bondX, where X is the number of the |
| 1064 | 1072 | bonding device to create, starting at 0. The first such file is |
| @@ -1066,49 +1074,52 @@ ifcfg-bond0, the second is ifcfg-bond1, and so on. The sysconfig · 1 unmodified line | ||
| 1066 | 1074 | network configuration system will correctly start multiple instances |
| 1067 | 1075 | of bonding. |
| 1068 | 1076 | |
| 1069 | − The contents of the ifcfg-bondX file is as follows: | |
| 1070 | − | |
| 1071 | −BOOTPROTO="static" | |
| 1072 | −BROADCAST="10.0.2.255" | |
| 1073 | −IPADDR="10.0.2.10" | |
| 1074 | −NETMASK="255.255.0.0" | |
| 1075 | −NETWORK="10.0.2.0" | |
| 1076 | −REMOTE_IPADDR="" | |
| 1077 | −STARTMODE="onboot" | |
| 1078 | −BONDING_MASTER="yes" | |
| 1079 | −BONDING_MODULE_OPTS="mode=active-backup miimon=100" | |
| 1080 | −BONDING_SLAVE0="eth0" | |
| 1081 | −BONDING_SLAVE1="bus-pci-0000:06:08.1" | |
| 1082 | − | |
| 1083 | − Replace the sample BROADCAST, IPADDR, NETMASK and NETWORK | |
| 1077 | +The contents of the ifcfg-bondX file is as follows:: | |
| 1078 | + | |
| 1079 | + BOOTPROTO="static" | |
| 1080 | + BROADCAST="10.0.2.255" | |
| 1081 | + IPADDR="10.0.2.10" | |
| 1082 | + NETMASK="255.255.0.0" | |
| 1083 | + NETWORK="10.0.2.0" | |
| 1084 | + REMOTE_IPADDR="" | |
| 1085 | + STARTMODE="onboot" | |
| 1086 | + BONDING_MASTER="yes" | |
| 1087 | + BONDING_MODULE_OPTS="mode=active-backup miimon=100" | |
| 1088 | + BONDING_SLAVE0="eth0" | |
| 1089 | + BONDING_SLAVE1="bus-pci-0000:06:08.1" | |
| 1090 | + | |
| 1091 | +Replace the sample BROADCAST, IPADDR, NETMASK and NETWORK | |
| 1084 | 1092 | values with the appropriate values for your network. |
| 1085 | 1093 | |
| 1086 | − The STARTMODE specifies when the device is brought online. | |
| 1094 | +The STARTMODE specifies when the device is brought online. | |
| 1087 | 1095 | The possible values are: |
| 1088 | 1096 | |
| 1089 | − onboot: The device is started at boot time. If you're not | |
| 1097 | + ======== ====================================================== | |
| 1098 | + onboot The device is started at boot time. If you're not | |
| 1090 | 1099 | sure, this is probably what you want. |
| 1091 | 1100 | |
| 1092 | − manual: The device is started only when ifup is called | |
| 1101 | + manual The device is started only when ifup is called | |
| 1093 | 1102 | manually. Bonding devices may be configured this |
| 1094 | 1103 | way if you do not wish them to start automatically |
| 1095 | 1104 | at boot for some reason. |
| 1096 | 1105 | |
| 1097 | − hotplug: The device is started by a hotplug event. This is not | |
| 1106 | + hotplug The device is started by a hotplug event. This is not | |
| 1098 | 1107 | a valid choice for a bonding device. |
| 1099 | 1108 | |
| 1100 | − off or ignore: The device configuration is ignored. | |
| 1109 | + off or The device configuration is ignored. | |
| 1110 | + ignore | |
| 1111 | + ======== ====================================================== | |
| 1101 | 1112 | |
| 1102 | − The line BONDING_MASTER='yes' indicates that the device is a | |
| 1113 | +The line BONDING_MASTER='yes' indicates that the device is a | |
| 1103 | 1114 | bonding master device. The only useful value is "yes." |
| 1104 | 1115 | |
| 1105 | − The contents of BONDING_MODULE_OPTS are supplied to the | |
| 1116 | +The contents of BONDING_MODULE_OPTS are supplied to the | |
| 1106 | 1117 | instance of the bonding module for this device. Specify the options |
| 1107 | 1118 | for the bonding mode, link monitoring, and so on here. Do not include |
| 1108 | 1119 | the max_bonds bonding parameter; this will confuse the configuration |
| 1109 | 1120 | system if you have multiple bonding devices. |
| 1110 | 1121 | |
| 1111 | − Finally, supply one BONDING_SLAVEn="slave device" for each | |
| 1122 | +Finally, supply one BONDING_SLAVEn="slave device" for each | |
| 1112 | 1123 | slave. where "n" is an increasing value, one for each slave. The |
| 1113 | 1124 | "slave device" is either an interface name, e.g., "eth0", or a device |
| 1114 | 1125 | specifier for the network device. The interface name is easier to |
| @@ -1120,34 +1131,34 @@ changes (for example, it is moved from one PCI slot to another). The · 5 unmodified lines | ||
| 1120 | 1131 | example above uses one of each type for demonstration purposes; most |
| 1121 | 1132 | configurations will choose one or the other for all slave devices. |
| 1122 | 1133 | |
| 1123 | − When all configuration files have been modified or created, | |
| 1134 | +When all configuration files have been modified or created, | |
| 1124 | 1135 | networking must be restarted for the configuration changes to take |
| 1125 | −effect. This can be accomplished via the following: | |
| 1136 | +effect. This can be accomplished via the following:: | |
| 1126 | 1137 | |
| 1127 | −# /etc/init.d/network restart | |
| 1138 | + # /etc/init.d/network restart | |
| 1128 | 1139 | |
| 1129 | − Note that the network control script (/sbin/ifdown) will | |
| 1140 | +Note that the network control script (/sbin/ifdown) will | |
| 1130 | 1141 | remove the bonding module as part of the network shutdown processing, |
| 1131 | 1142 | so it is not necessary to remove the module by hand if, e.g., the |
| 1132 | 1143 | module parameters have changed. |
| 1133 | 1144 | |
| 1134 | − Also, at this writing, YaST/YaST2 will not manage bonding | |
| 1145 | +Also, at this writing, YaST/YaST2 will not manage bonding | |
| 1135 | 1146 | devices (they do not show bonding interfaces on its list of network |
| 1136 | 1147 | devices). It is necessary to edit the configuration file by hand to |
| 1137 | 1148 | change the bonding configuration. |
| 1138 | 1149 | |
| 1139 | − Additional general options and details of the ifcfg file | |
| 1140 | −format can be found in an example ifcfg template file: | |
| 1150 | +Additional general options and details of the ifcfg file | |
| 1151 | +format can be found in an example ifcfg template file:: | |
| 1141 | 1152 | |
| 1142 | −/etc/sysconfig/network/ifcfg.template | |
| 1153 | + /etc/sysconfig/network/ifcfg.template | |
| 1143 | 1154 | |
| 1144 | − Note that the template does not document the various BONDING_ | |
| 1155 | +Note that the template does not document the various ``BONDING_*`` | |
| 1145 | 1156 | settings described above, but does describe many of the other options. |
| 1146 | 1157 | |
| 1147 | 1158 | 3.1.1 Using DHCP with Sysconfig |
| 1148 | 1159 | ------------------------------- |
| 1149 | 1160 | |
| 1150 | − Under sysconfig, configuring a device with BOOTPROTO='dhcp' | |
| 1161 | +Under sysconfig, configuring a device with BOOTPROTO='dhcp' | |
| 1151 | 1162 | will cause it to query DHCP for its IP address information. At this |
| 1152 | 1163 | writing, this does not function for bonding devices; the scripts |
| 1153 | 1164 | attempt to obtain the device address from DHCP prior to adding any of |
| @@ -1157,7 +1168,7 @@ sent to the network. · 3 unmodified lines | ||
| 1157 | 1168 | 3.1.2 Configuring Multiple Bonds with Sysconfig |
| 1158 | 1169 | ----------------------------------------------- |
| 1159 | 1170 | |
| 1160 | − The sysconfig network initialization system is capable of | |
| 1171 | +The sysconfig network initialization system is capable of | |
| 1161 | 1172 | handling multiple bonding devices. All that is necessary is for each |
| 1162 | 1173 | bonding instance to have an appropriately configured ifcfg-bondX file |
| 1163 | 1174 | (as described above). Do not specify the "max_bonds" parameter to any |
| @@ -1165,14 +1176,14 @@ instance of bonding, as this will confuse sysconfig. If you require · 1 unmodified line | ||
| 1165 | 1176 | multiple bonding devices with identical parameters, create multiple |
| 1166 | 1177 | ifcfg-bondX files. |
| 1167 | 1178 | |
| 1168 | − Because the sysconfig scripts supply the bonding module | |
| 1179 | +Because the sysconfig scripts supply the bonding module | |
| 1169 | 1180 | options in the ifcfg-bondX file, it is not necessary to add them to |
| 1170 | −the system /etc/modules.d/*.conf configuration files. | |
| 1181 | +the system ``/etc/modules.d/*.conf`` configuration files. | |
| 1171 | 1182 | |
| 1172 | 1183 | 3.2 Configuration with Initscripts Support |
| 1173 | 1184 | ------------------------------------------ |
| 1174 | 1185 | |
| 1175 | − This section applies to distros using a recent version of | |
| 1186 | +This section applies to distros using a recent version of | |
| 1176 | 1187 | initscripts with bonding support, for example, Red Hat Enterprise Linux |
| 1177 | 1188 | version 3 or later, Fedora, etc. On these systems, the network |
| 1178 | 1189 | initialization scripts have knowledge of bonding, and can be configured to |
| @@ -1180,7 +1191,7 @@ control bonding devices. Note that older versions of the initscripts · 1 unmodified line | ||
| 1180 | 1191 | package have lower levels of support for bonding; this will be noted where |
| 1181 | 1192 | applicable. |
| 1182 | 1193 | |
| 1183 | − These distros will not automatically load the network adapter | |
| 1194 | +These distros will not automatically load the network adapter | |
| 1184 | 1195 | driver unless the ethX device is configured with an IP address. |
| 1185 | 1196 | Because of this constraint, users must manually configure a |
| 1186 | 1197 | network-script file for all physical adapters that will be members of |
| @@ -1188,19 +1199,19 @@ a bondX link. Network script files are located in the directory: · 1 unmodified line | ||
| 1188 | 1199 | |
| 1189 | 1200 | /etc/sysconfig/network-scripts |
| 1190 | 1201 | |
| 1191 | − The file name must be prefixed with "ifcfg-eth" and suffixed | |
| 1202 | +The file name must be prefixed with "ifcfg-eth" and suffixed | |
| 1192 | 1203 | with the adapter's physical adapter number. For example, the script |
| 1193 | 1204 | for eth0 would be named /etc/sysconfig/network-scripts/ifcfg-eth0. |
| 1194 | −Place the following text in the file: | |
| 1205 | +Place the following text in the file:: | |
| 1195 | 1206 | |
| 1196 | −DEVICE=eth0 | |
| 1197 | −USERCTL=no | |
| 1198 | −ONBOOT=yes | |
| 1199 | −MASTER=bond0 | |
| 1200 | −SLAVE=yes | |
| 1201 | −BOOTPROTO=none | |
| 1207 | + DEVICE=eth0 | |
| 1208 | + USERCTL=no | |
| 1209 | + ONBOOT=yes | |
| 1210 | + MASTER=bond0 | |
| 1211 | + SLAVE=yes | |
| 1212 | + BOOTPROTO=none | |
| 1202 | 1213 | |
| 1203 | − The DEVICE= line will be different for every ethX device and | |
| 1214 | +The DEVICE= line will be different for every ethX device and | |
| 1204 | 1215 | must correspond with the name of the file, i.e., ifcfg-eth1 must have |
| 1205 | 1216 | a device line of DEVICE=eth1. The setting of the MASTER= line will |
| 1206 | 1217 | also depend on the final bonding interface name chosen for your bond. |
| @@ -1208,69 +1219,70 @@ As with other network devices, these typically start at 0, and go up · 1 unmodified line | ||
| 1208 | 1219 | one for each device, i.e., the first bonding instance is bond0, the |
| 1209 | 1220 | second is bond1, and so on. |
| 1210 | 1221 | |
| 1211 | − Next, create a bond network script. The file name for this | |
| 1222 | +Next, create a bond network script. The file name for this | |
| 1212 | 1223 | script will be /etc/sysconfig/network-scripts/ifcfg-bondX where X is |
| 1213 | 1224 | the number of the bond. For bond0 the file is named "ifcfg-bond0", |
| 1214 | 1225 | for bond1 it is named "ifcfg-bond1", and so on. Within that file, |
| 1215 | −place the following text: | |
| 1216 | − | |
| 1217 | −DEVICE=bond0 | |
| 1218 | −IPADDR=192.168.1.1 | |
| 1219 | −NETMASK=255.255.255.0 | |
| 1220 | −NETWORK=192.168.1.0 | |
| 1221 | −BROADCAST=192.168.1.255 | |
| 1222 | −ONBOOT=yes | |
| 1223 | −BOOTPROTO=none | |
| 1224 | −USERCTL=no | |
| 1225 | − | |
| 1226 | − Be sure to change the networking specific lines (IPADDR, | |
| 1226 | +place the following text:: | |
| 1227 | + | |
| 1228 | + DEVICE=bond0 | |
| 1229 | + IPADDR=192.168.1.1 | |
| 1230 | + NETMASK=255.255.255.0 | |
| 1231 | + NETWORK=192.168.1.0 | |
| 1232 | + BROADCAST=192.168.1.255 | |
| 1233 | + ONBOOT=yes | |
| 1234 | + BOOTPROTO=none | |
| 1235 | + USERCTL=no | |
| 1236 | + | |
| 1237 | +Be sure to change the networking specific lines (IPADDR, | |
| 1227 | 1238 | NETMASK, NETWORK and BROADCAST) to match your network configuration. |
| 1228 | 1239 | |
| 1229 | − For later versions of initscripts, such as that found with Fedora | |
| 1240 | +For later versions of initscripts, such as that found with Fedora | |
| 1230 | 1241 | 7 (or later) and Red Hat Enterprise Linux version 5 (or later), it is possible, |
| 1231 | 1242 | and, indeed, preferable, to specify the bonding options in the ifcfg-bond0 |
| 1232 | −file, e.g. a line of the format: | |
| 1243 | +file, e.g. a line of the format:: | |
| 1233 | 1244 | |
| 1234 | −BONDING_OPTS="mode=active-backup arp_interval=60 arp_ip_target=192.168.1.254" | |
| 1245 | + BONDING_OPTS="mode=active-backup arp_interval=60 arp_ip_target=192.168.1.254" | |
| 1235 | 1246 | |
| 1236 | − will configure the bond with the specified options. The options | |
| 1247 | +will configure the bond with the specified options. The options | |
| 1237 | 1248 | specified in BONDING_OPTS are identical to the bonding module parameters |
| 1238 | 1249 | except for the arp_ip_target field when using versions of initscripts older |
| 1239 | 1250 | than and 8.57 (Fedora 8) and 8.45.19 (Red Hat Enterprise Linux 5.2). When |
| 1240 | 1251 | using older versions each target should be included as a separate option and |
| 1241 | 1252 | should be preceded by a '+' to indicate it should be added to the list of |
| 1242 | −queried targets, e.g., | |
| 1253 | +queried targets, e.g.,:: | |
| 1243 | 1254 | |
| 1244 | − arp_ip_target=+192.168.1.1 arp_ip_target=+192.168.1.2 | |
| 1255 | + arp_ip_target=+192.168.1.1 arp_ip_target=+192.168.1.2 | |
| 1245 | 1256 | |
| 1246 | − is the proper syntax to specify multiple targets. When specifying | |
| 1247 | −options via BONDING_OPTS, it is not necessary to edit /etc/modprobe.d/*.conf. | |
| 1257 | +is the proper syntax to specify multiple targets. When specifying | |
| 1258 | +options via BONDING_OPTS, it is not necessary to edit | |
| 1259 | +``/etc/modprobe.d/*.conf``. | |
| 1248 | 1260 | |
| 1249 | − For even older versions of initscripts that do not support | |
| 1261 | +For even older versions of initscripts that do not support | |
| 1250 | 1262 | BONDING_OPTS, it is necessary to edit /etc/modprobe.d/*.conf, depending upon |
| 1251 | 1263 | your distro) to load the bonding module with your desired options when the |
| 1252 | 1264 | bond0 interface is brought up. The following lines in /etc/modprobe.d/*.conf |
| 1253 | 1265 | will load the bonding module, and select its options: |
| 1254 | 1266 | |
| 1255 | −alias bond0 bonding | |
| 1256 | −options bond0 mode=balance-alb miimon=100 | |
| 1267 | + alias bond0 bonding | |
| 1268 | + options bond0 mode=balance-alb miimon=100 | |
| 1257 | 1269 | |
| 1258 | − Replace the sample parameters with the appropriate set of | |
| 1270 | +Replace the sample parameters with the appropriate set of | |
| 1259 | 1271 | options for your configuration. |
| 1260 | 1272 | |
| 1261 | − Finally run "/etc/rc.d/init.d/network restart" as root. This | |
| 1273 | +Finally run "/etc/rc.d/init.d/network restart" as root. This | |
| 1262 | 1274 | will restart the networking subsystem and your bond link should be now |
| 1263 | 1275 | up and running. |
| 1264 | 1276 | |
| 1265 | 1277 | 3.2.1 Using DHCP with Initscripts |
| 1266 | 1278 | --------------------------------- |
| 1267 | 1279 | |
| 1268 | − Recent versions of initscripts (the versions supplied with Fedora | |
| 1280 | +Recent versions of initscripts (the versions supplied with Fedora | |
| 1269 | 1281 | Core 3 and Red Hat Enterprise Linux 4, or later versions, are reported to |
| 1270 | 1282 | work) have support for assigning IP information to bonding devices via |
| 1271 | 1283 | DHCP. |
| 1272 | 1284 | |
| 1273 | − To configure bonding for DHCP, configure it as described | |
| 1285 | +To configure bonding for DHCP, configure it as described | |
| 1274 | 1286 | above, except replace the line "BOOTPROTO=none" with "BOOTPROTO=dhcp" |
| 1275 | 1287 | and add a line consisting of "TYPE=Bonding". Note that the TYPE value |
| 1276 | 1288 | is case sensitive. |
| @@ -1278,7 +1290,7 @@ is case sensitive. · 1 unmodified line | ||
| 1278 | 1290 | 3.2.2 Configuring Multiple Bonds with Initscripts |
| 1279 | 1291 | ------------------------------------------------- |
| 1280 | 1292 | |
| 1281 | − Initscripts packages that are included with Fedora 7 and Red Hat | |
| 1293 | +Initscripts packages that are included with Fedora 7 and Red Hat | |
| 1282 | 1294 | Enterprise Linux 5 support multiple bonding interfaces by simply |
| 1283 | 1295 | specifying the appropriate BONDING_OPTS= in ifcfg-bondX where X is the |
| 1284 | 1296 | number of the bond. This support requires sysfs support in the kernel, |
| @@ -1290,77 +1302,77 @@ below. · 5 unmodified lines | ||
| 1290 | 1302 | 3.3 Configuring Bonding Manually with iproute2 |
| 1291 | 1303 | ----------------------------------------------- |
| 1292 | 1304 | |
| 1293 | − This section applies to distros whose network initialization | |
| 1305 | +This section applies to distros whose network initialization | |
| 1294 | 1306 | scripts (the sysconfig or initscripts package) do not have specific |
| 1295 | 1307 | knowledge of bonding. One such distro is SuSE Linux Enterprise Server |
| 1296 | 1308 | version 8. |
| 1297 | 1309 | |
| 1298 | − The general method for these systems is to place the bonding | |
| 1310 | +The general method for these systems is to place the bonding | |
| 1299 | 1311 | module parameters into a config file in /etc/modprobe.d/ (as |
| 1300 | 1312 | appropriate for the installed distro), then add modprobe and/or |
| 1301 | 1313 | `ip link` commands to the system's global init script. The name of |
| 1302 | 1314 | the global init script differs; for sysconfig, it is |
| 1303 | 1315 | /etc/init.d/boot.local and for initscripts it is /etc/rc.d/rc.local. |
| 1304 | 1316 | |
| 1305 | − For example, if you wanted to make a simple bond of two e100 | |
| 1317 | +For example, if you wanted to make a simple bond of two e100 | |
| 1306 | 1318 | devices (presumed to be eth0 and eth1), and have it persist across |
| 1307 | 1319 | reboots, edit the appropriate file (/etc/init.d/boot.local or |
| 1308 | −/etc/rc.d/rc.local), and add the following: | |
| 1320 | +/etc/rc.d/rc.local), and add the following:: | |
| 1309 | 1321 | |
| 1310 | −modprobe bonding mode=balance-alb miimon=100 | |
| 1311 | −modprobe e100 | |
| 1312 | −ifconfig bond0 192.168.1.1 netmask 255.255.255.0 up | |
| 1313 | −ip link set eth0 master bond0 | |
| 1314 | −ip link set eth1 master bond0 | |
| 1322 | + modprobe bonding mode=balance-alb miimon=100 | |
| 1323 | + modprobe e100 | |
| 1324 | + ifconfig bond0 192.168.1.1 netmask 255.255.255.0 up | |
| 1325 | + ip link set eth0 master bond0 | |
| 1326 | + ip link set eth1 master bond0 | |
| 1315 | 1327 | |
| 1316 | − Replace the example bonding module parameters and bond0 | |
| 1328 | +Replace the example bonding module parameters and bond0 | |
| 1317 | 1329 | network configuration (IP address, netmask, etc) with the appropriate |
| 1318 | 1330 | values for your configuration. |
| 1319 | 1331 | |
| 1320 | − Unfortunately, this method will not provide support for the | |
| 1332 | +Unfortunately, this method will not provide support for the | |
| 1321 | 1333 | ifup and ifdown scripts on the bond devices. To reload the bonding |
| 1322 | −configuration, it is necessary to run the initialization script, e.g., | |
| 1334 | +configuration, it is necessary to run the initialization script, e.g.,:: | |
| 1323 | 1335 | |
| 1324 | −# /etc/init.d/boot.local | |
| 1336 | + # /etc/init.d/boot.local | |
| 1325 | 1337 | |
| 1326 | − or | |
| 1338 | +or:: | |
| 1327 | 1339 | |
| 1328 | −# /etc/rc.d/rc.local | |
| 1340 | + # /etc/rc.d/rc.local | |
| 1329 | 1341 | |
| 1330 | − It may be desirable in such a case to create a separate script | |
| 1342 | +It may be desirable in such a case to create a separate script | |
| 1331 | 1343 | which only initializes the bonding configuration, then call that |
| 1332 | 1344 | separate script from within boot.local. This allows for bonding to be |
| 1333 | 1345 | enabled without re-running the entire global init script. |
| 1334 | 1346 | |
| 1335 | − To shut down the bonding devices, it is necessary to first | |
| 1347 | +To shut down the bonding devices, it is necessary to first | |
| 1336 | 1348 | mark the bonding device itself as being down, then remove the |
| 1337 | 1349 | appropriate device driver modules. For our example above, you can do |
| 1338 | −the following: | |
| 1350 | +the following:: | |
| 1339 | 1351 | |
| 1340 | −# ifconfig bond0 down | |
| 1341 | −# rmmod bonding | |
| 1342 | −# rmmod e100 | |
| 1352 | + # ifconfig bond0 down | |
| 1353 | + # rmmod bonding | |
| 1354 | + # rmmod e100 | |
| 1343 | 1355 | |
| 1344 | − Again, for convenience, it may be desirable to create a script | |
| 1356 | +Again, for convenience, it may be desirable to create a script | |
| 1345 | 1357 | with these commands. |
| 1346 | 1358 | |
| 1347 | 1359 | |
| 1348 | 1360 | 3.3.1 Configuring Multiple Bonds Manually |
| 1349 | 1361 | ----------------------------------------- |
| 1350 | 1362 | |
| 1351 | − This section contains information on configuring multiple | |
| 1363 | +This section contains information on configuring multiple | |
| 1352 | 1364 | bonding devices with differing options for those systems whose network |
| 1353 | 1365 | initialization scripts lack support for configuring multiple bonds. |
| 1354 | 1366 | |
| 1355 | − If you require multiple bonding devices, but all with the same | |
| 1367 | +If you require multiple bonding devices, but all with the same | |
| 1356 | 1368 | options, you may wish to use the "max_bonds" module parameter, |
| 1357 | 1369 | documented above. |
| 1358 | 1370 | |
| 1359 | − To create multiple bonding devices with differing options, it is | |
| 1371 | +To create multiple bonding devices with differing options, it is | |
| 1360 | 1372 | preferable to use bonding parameters exported by sysfs, documented in the |
| 1361 | 1373 | section below. |
| 1362 | 1374 | |
| 1363 | − For versions of bonding without sysfs support, the only means to | |
| 1375 | +For versions of bonding without sysfs support, the only means to | |
| 1364 | 1376 | provide multiple instances of bonding with differing options is to load |
| 1365 | 1377 | the bonding driver multiple times. Note that current versions of the |
| 1366 | 1378 | sysconfig network initialization scripts handle this automatically; if |
| @@ -1368,35 +1380,35 @@ your distro uses these scripts, no special action is needed. See the · 1 unmodified line | ||
| 1368 | 1380 | section Configuring Bonding Devices, above, if you're not sure about your |
| 1369 | 1381 | network initialization scripts. |
| 1370 | 1382 | |
| 1371 | − To load multiple instances of the module, it is necessary to | |
| 1383 | +To load multiple instances of the module, it is necessary to | |
| 1372 | 1384 | specify a different name for each instance (the module loading system |
| 1373 | 1385 | requires that every loaded module, even multiple instances of the same |
| 1374 | 1386 | module, have a unique name). This is accomplished by supplying multiple |
| 1375 | −sets of bonding options in /etc/modprobe.d/*.conf, for example: | |
| 1387 | +sets of bonding options in ``/etc/modprobe.d/*.conf``, for example:: | |
| 1376 | 1388 | |
| 1377 | −alias bond0 bonding | |
| 1378 | −options bond0 -o bond0 mode=balance-rr miimon=100 | |
| 1389 | + alias bond0 bonding | |
| 1390 | + options bond0 -o bond0 mode=balance-rr miimon=100 | |
| 1379 | 1391 | |
| 1380 | −alias bond1 bonding | |
| 1381 | −options bond1 -o bond1 mode=balance-alb miimon=50 | |
| 1392 | + alias bond1 bonding | |
| 1393 | + options bond1 -o bond1 mode=balance-alb miimon=50 | |
| 1382 | 1394 | |
| 1383 | − will load the bonding module two times. The first instance is | |
| 1395 | +will load the bonding module two times. The first instance is | |
| 1384 | 1396 | named "bond0" and creates the bond0 device in balance-rr mode with an |
| 1385 | 1397 | miimon of 100. The second instance is named "bond1" and creates the |
| 1386 | 1398 | bond1 device in balance-alb mode with an miimon of 50. |
| 1387 | 1399 | |
| 1388 | − In some circumstances (typically with older distributions), | |
| 1400 | +In some circumstances (typically with older distributions), | |
| 1389 | 1401 | the above does not work, and the second bonding instance never sees |
| 1390 | 1402 | its options. In that case, the second options line can be substituted |
| 1391 | −as follows: | |
| 1403 | +as follows:: | |
| 1392 | 1404 | |
| 1393 | −install bond1 /sbin/modprobe --ignore-install bonding -o bond1 \ | |
| 1394 | − mode=balance-alb miimon=50 | |
| 1405 | + install bond1 /sbin/modprobe --ignore-install bonding -o bond1 \ | |
| 1406 | + mode=balance-alb miimon=50 | |
| 1395 | 1407 | |
| 1396 | − This may be repeated any number of times, specifying a new and | |
| 1408 | +This may be repeated any number of times, specifying a new and | |
| 1397 | 1409 | unique name in place of bond1 for each subsequent instance. |
| 1398 | 1410 | |
| 1399 | − It has been observed that some Red Hat supplied kernels are unable | |
| 1411 | +It has been observed that some Red Hat supplied kernels are unable | |
| 1400 | 1412 | to rename modules at load time (the "-o bond1" part). Attempts to pass |
| 1401 | 1413 | that option to modprobe will produce an "Operation not permitted" error. |
| 1402 | 1414 | This has been reported on some Fedora Core kernels, and has been seen on |
| @@ -1407,18 +1419,18 @@ kernels, and also lack sysfs support). · 4 unmodified lines | ||
| 1407 | 1419 | 3.4 Configuring Bonding Manually via Sysfs |
| 1408 | 1420 | ------------------------------------------ |
| 1409 | 1421 | |
| 1410 | − Starting with version 3.0.0, Channel Bonding may be configured | |
| 1422 | +Starting with version 3.0.0, Channel Bonding may be configured | |
| 1411 | 1423 | via the sysfs interface. This interface allows dynamic configuration |
| 1412 | 1424 | of all bonds in the system without unloading the module. It also |
| 1413 | 1425 | allows for adding and removing bonds at runtime. Ifenslave is no |
| 1414 | 1426 | longer required, though it is still supported. |
| 1415 | 1427 | |
| 1416 | − Use of the sysfs interface allows you to use multiple bonds | |
| 1428 | +Use of the sysfs interface allows you to use multiple bonds | |
| 1417 | 1429 | with different configurations without having to reload the module. |
| 1418 | 1430 | It also allows you to use multiple, differently configured bonds when |
| 1419 | 1431 | bonding is compiled into the kernel. |
| 1420 | 1432 | |
| 1421 | − You must have the sysfs filesystem mounted to configure | |
| 1433 | +You must have the sysfs filesystem mounted to configure | |
| 1422 | 1434 | bonding this way. The examples in this document assume that you |
| 1423 | 1435 | are using the standard mount point for sysfs, e.g. /sys. If your |
| 1424 | 1436 | sysfs filesystem is mounted elsewhere, you will need to adjust the |
| @@ -1426,38 +1438,45 @@ example paths accordingly. · 1 unmodified line | ||
| 1426 | 1438 | |
| 1427 | 1439 | Creating and Destroying Bonds |
| 1428 | 1440 | ----------------------------- |
| 1429 | −To add a new bond foo: | |
| 1430 | −# echo +foo > /sys/class/net/bonding_masters | |
| 1441 | +To add a new bond foo:: | |
| 1442 | + | |
| 1443 | + # echo +foo > /sys/class/net/bonding_masters | |
| 1444 | + | |
| 1445 | +To remove an existing bond bar:: | |
| 1431 | 1446 | |
| 1432 | −To remove an existing bond bar: | |
| 1433 | −# echo -bar > /sys/class/net/bonding_masters | |
| 1447 | + # echo -bar > /sys/class/net/bonding_masters | |
| 1434 | 1448 | |
| 1435 | −To show all existing bonds: | |
| 1436 | −# cat /sys/class/net/bonding_masters | |
| 1449 | +To show all existing bonds:: | |
| 1437 | 1450 | |
| 1438 | −NOTE: due to 4K size limitation of sysfs files, this list may be | |
| 1439 | −truncated if you have more than a few hundred bonds. This is unlikely | |
| 1440 | −to occur under normal operating conditions. | |
| 1451 | + # cat /sys/class/net/bonding_masters | |
| 1452 | + | |
| 1453 | +.. note:: | |
| 1454 | + | |
| 1455 | + due to 4K size limitation of sysfs files, this list may be | |
| 1456 | + truncated if you have more than a few hundred bonds. This is unlikely | |
| 1457 | + to occur under normal operating conditions. | |
| 1441 | 1458 | |
| 1442 | 1459 | Adding and Removing Slaves |
| 1443 | 1460 | -------------------------- |
| 1444 | − Interfaces may be enslaved to a bond using the file | |
| 1461 | +Interfaces may be enslaved to a bond using the file | |
| 1445 | 1462 | /sys/class/net/<bond>/bonding/slaves. The semantics for this file |
| 1446 | 1463 | are the same as for the bonding_masters file. |
| 1447 | 1464 | |
| 1448 | −To enslave interface eth0 to bond bond0: | |
| 1449 | −# ifconfig bond0 up | |
| 1450 | −# echo +eth0 > /sys/class/net/bond0/bonding/slaves | |
| 1465 | +To enslave interface eth0 to bond bond0:: | |
| 1466 | + | |
| 1467 | + # ifconfig bond0 up | |
| 1468 | + # echo +eth0 > /sys/class/net/bond0/bonding/slaves | |
| 1451 | 1469 | |
| 1452 | −To free slave eth0 from bond bond0: | |
| 1453 | −# echo -eth0 > /sys/class/net/bond0/bonding/slaves | |
| 1470 | +To free slave eth0 from bond bond0:: | |
| 1454 | 1471 | |
| 1455 | − When an interface is enslaved to a bond, symlinks between the | |
| 1472 | + # echo -eth0 > /sys/class/net/bond0/bonding/slaves | |
| 1473 | + | |
| 1474 | +When an interface is enslaved to a bond, symlinks between the | |
| 1456 | 1475 | two are created in the sysfs filesystem. In this case, you would get |
| 1457 | 1476 | /sys/class/net/bond0/slave_eth0 pointing to /sys/class/net/eth0, and |
| 1458 | 1477 | /sys/class/net/eth0/master pointing to /sys/class/net/bond0. |
| 1459 | 1478 | |
| 1460 | − This means that you can tell quickly whether or not an | |
| 1479 | +This means that you can tell quickly whether or not an | |
| 1461 | 1480 | interface is enslaved by looking for the master symlink. Thus: |
| 1462 | 1481 | # echo -eth0 > /sys/class/net/eth0/master/bonding/slaves |
| 1463 | 1482 | will free eth0 from whatever bond it is enslaved to, regardless of |
| @@ -1465,127 +1484,143 @@ the name of the bond interface. · 1 unmodified line | ||
| 1465 | 1484 | |
| 1466 | 1485 | Changing a Bond's Configuration |
| 1467 | 1486 | ------------------------------- |
| 1468 | − Each bond may be configured individually by manipulating the | |
| 1487 | +Each bond may be configured individually by manipulating the | |
| 1469 | 1488 | files located in /sys/class/net/<bond name>/bonding |
| 1470 | 1489 | |
| 1471 | − The names of these files correspond directly with the command- | |
| 1490 | +The names of these files correspond directly with the command- | |
| 1472 | 1491 | line parameters described elsewhere in this file, and, with the |
| 1473 | 1492 | exception of arp_ip_target, they accept the same values. To see the |
| 1474 | 1493 | current setting, simply cat the appropriate file. |
| 1475 | 1494 | |
| 1476 | − A few examples will be given here; for specific usage | |
| 1495 | +A few examples will be given here; for specific usage | |
| 1477 | 1496 | guidelines for each parameter, see the appropriate section in this |
| 1478 | 1497 | document. |
| 1479 | 1498 | |
| 1480 | −To configure bond0 for balance-alb mode: | |
| 1481 | −# ifconfig bond0 down | |
| 1482 | −# echo 6 > /sys/class/net/bond0/bonding/mode | |
| 1483 | − - or - | |
| 1484 | −# echo balance-alb > /sys/class/net/bond0/bonding/mode | |
| 1485 | − NOTE: The bond interface must be down before the mode can be | |
| 1486 | −changed. | |
| 1487 | − | |
| 1488 | −To enable MII monitoring on bond0 with a 1 second interval: | |
| 1489 | −# echo 1000 > /sys/class/net/bond0/bonding/miimon | |
| 1490 | − NOTE: If ARP monitoring is enabled, it will disabled when MII | |
| 1491 | −monitoring is enabled, and vice-versa. | |
| 1492 | − | |
| 1493 | −To add ARP targets: | |
| 1494 | −# echo +192.168.0.100 > /sys/class/net/bond0/bonding/arp_ip_target | |
| 1495 | −# echo +192.168.0.101 > /sys/class/net/bond0/bonding/arp_ip_target | |
| 1496 | − NOTE: up to 16 target addresses may be specified. | |
| 1497 | − | |
| 1498 | −To remove an ARP target: | |
| 1499 | −# echo -192.168.0.100 > /sys/class/net/bond0/bonding/arp_ip_target | |
| 1500 | − | |
| 1501 | −To configure the interval between learning packet transmits: | |
| 1502 | −# echo 12 > /sys/class/net/bond0/bonding/lp_interval | |
| 1503 | − NOTE: the lp_interval is the number of seconds between instances where | |
| 1504 | −the bonding driver sends learning packets to each slaves peer switch. The | |
| 1505 | −default interval is 1 second. | |
| 1499 | +To configure bond0 for balance-alb mode:: | |
| 1500 | + | |
| 1501 | + # ifconfig bond0 down | |
| 1502 | + # echo 6 > /sys/class/net/bond0/bonding/mode | |
| 1503 | + - or - | |
| 1504 | + # echo balance-alb > /sys/class/net/bond0/bonding/mode | |
| 1505 | + | |
| 1506 | +.. note:: | |
| 1507 | + | |
| 1508 | + The bond interface must be down before the mode can be changed. | |
| 1509 | + | |
| 1510 | +To enable MII monitoring on bond0 with a 1 second interval:: | |
| 1511 | + | |
| 1512 | + # echo 1000 > /sys/class/net/bond0/bonding/miimon | |
| 1513 | + | |
| 1514 | +.. note:: | |
| 1515 | + | |
| 1516 | + If ARP monitoring is enabled, it will disabled when MII | |
| 1517 | + monitoring is enabled, and vice-versa. | |
| 1518 | + | |
| 1519 | +To add ARP targets:: | |
| 1520 | + | |
| 1521 | + # echo +192.168.0.100 > /sys/class/net/bond0/bonding/arp_ip_target | |
| 1522 | + # echo +192.168.0.101 > /sys/class/net/bond0/bonding/arp_ip_target | |
| 1523 | + | |
| 1524 | +.. note:: | |
| 1525 | + | |
| 1526 | + up to 16 target addresses may be specified. | |
| 1527 | + | |
| 1528 | +To remove an ARP target:: | |
| 1529 | + | |
| 1530 | + # echo -192.168.0.100 > /sys/class/net/bond0/bonding/arp_ip_target | |
| 1531 | + | |
| 1532 | +To configure the interval between learning packet transmits:: | |
| 1533 | + | |
| 1534 | + # echo 12 > /sys/class/net/bond0/bonding/lp_interval | |
| 1535 | + | |
| 1536 | +.. note:: | |
| 1537 | + | |
| 1538 | + the lp_interval is the number of seconds between instances where | |
| 1539 | + the bonding driver sends learning packets to each slaves peer switch. The | |
| 1540 | + default interval is 1 second. | |
| 1506 | 1541 | |
| 1507 | 1542 | Example Configuration |
| 1508 | 1543 | --------------------- |
| 1509 | − We begin with the same example that is shown in section 3.3, | |
| 1544 | +We begin with the same example that is shown in section 3.3, | |
| 1510 | 1545 | executed with sysfs, and without using ifenslave. |
| 1511 | 1546 | |
| 1512 | − To make a simple bond of two e100 devices (presumed to be eth0 | |
| 1547 | +To make a simple bond of two e100 devices (presumed to be eth0 | |
| 1513 | 1548 | and eth1), and have it persist across reboots, edit the appropriate |
| 1514 | 1549 | file (/etc/init.d/boot.local or /etc/rc.d/rc.local), and add the |
| 1515 | −following: | |
| 1550 | +following:: | |
| 1516 | 1551 | |
| 1517 | −modprobe bonding | |
| 1518 | −modprobe e100 | |
| 1519 | −echo balance-alb > /sys/class/net/bond0/bonding/mode | |
| 1520 | −ifconfig bond0 192.168.1.1 netmask 255.255.255.0 up | |
| 1521 | −echo 100 > /sys/class/net/bond0/bonding/miimon | |
| 1522 | −echo +eth0 > /sys/class/net/bond0/bonding/slaves | |
| 1523 | −echo +eth1 > /sys/class/net/bond0/bonding/slaves | |
| 1552 | + modprobe bonding | |
| 1553 | + modprobe e100 | |
| 1554 | + echo balance-alb > /sys/class/net/bond0/bonding/mode | |
| 1555 | + ifconfig bond0 192.168.1.1 netmask 255.255.255.0 up | |
| 1556 | + echo 100 > /sys/class/net/bond0/bonding/miimon | |
| 1557 | + echo +eth0 > /sys/class/net/bond0/bonding/slaves | |
| 1558 | + echo +eth1 > /sys/class/net/bond0/bonding/slaves | |
| 1524 | 1559 | |
| 1525 | − To add a second bond, with two e1000 interfaces in | |
| 1560 | +To add a second bond, with two e1000 interfaces in | |
| 1526 | 1561 | active-backup mode, using ARP monitoring, add the following lines to |
| 1527 | −your init script: | |
| 1562 | +your init script:: | |
| 1528 | 1563 | |
| 1529 | −modprobe e1000 | |
| 1530 | −echo +bond1 > /sys/class/net/bonding_masters | |
| 1531 | −echo active-backup > /sys/class/net/bond1/bonding/mode | |
| 1532 | −ifconfig bond1 192.168.2.1 netmask 255.255.255.0 up | |
| 1533 | −echo +192.168.2.100 /sys/class/net/bond1/bonding/arp_ip_target | |
| 1534 | −echo 2000 > /sys/class/net/bond1/bonding/arp_interval | |
| 1535 | −echo +eth2 > /sys/class/net/bond1/bonding/slaves | |
| 1536 | −echo +eth3 > /sys/class/net/bond1/bonding/slaves | |
| 1564 | + modprobe e1000 | |
| 1565 | + echo +bond1 > /sys/class/net/bonding_masters | |
| 1566 | + echo active-backup > /sys/class/net/bond1/bonding/mode | |
| 1567 | + ifconfig bond1 192.168.2.1 netmask 255.255.255.0 up | |
| 1568 | + echo +192.168.2.100 /sys/class/net/bond1/bonding/arp_ip_target | |
| 1569 | + echo 2000 > /sys/class/net/bond1/bonding/arp_interval | |
| 1570 | + echo +eth2 > /sys/class/net/bond1/bonding/slaves | |
| 1571 | + echo +eth3 > /sys/class/net/bond1/bonding/slaves | |
| 1537 | 1572 | |
| 1538 | 1573 | 3.5 Configuration with Interfaces Support |
| 1539 | 1574 | ----------------------------------------- |
| 1540 | 1575 | |
| 1541 | − This section applies to distros which use /etc/network/interfaces file | |
| 1576 | +This section applies to distros which use /etc/network/interfaces file | |
| 1542 | 1577 | to describe network interface configuration, most notably Debian and it's |
| 1543 | 1578 | derivatives. |
| 1544 | 1579 | |
| 1545 | − The ifup and ifdown commands on Debian don't support bonding out of | |
| 1580 | +The ifup and ifdown commands on Debian don't support bonding out of | |
| 1546 | 1581 | the box. The ifenslave-2.6 package should be installed to provide bonding |
| 1547 | −support. Once installed, this package will provide bond-* options to be used | |
| 1548 | −into /etc/network/interfaces. | |
| 1582 | +support. Once installed, this package will provide ``bond-*`` options | |
| 1583 | +to be used into /etc/network/interfaces. | |
| 1549 | 1584 | |
| 1550 | − Note that ifenslave-2.6 package will load the bonding module and use | |
| 1585 | +Note that ifenslave-2.6 package will load the bonding module and use | |
| 1551 | 1586 | the ifenslave command when appropriate. |
| 1552 | 1587 | |
| 1553 | 1588 | Example Configurations |
| 1554 | 1589 | ---------------------- |
| 1555 | 1590 | |
| 1556 | 1591 | In /etc/network/interfaces, the following stanza will configure bond0, in |
| 1557 | −active-backup mode, with eth0 and eth1 as slaves. | |
| 1592 | +active-backup mode, with eth0 and eth1 as slaves:: | |
| 1558 | 1593 | |
| 1559 | −auto bond0 | |
| 1560 | −iface bond0 inet dhcp | |
| 1561 | − bond-slaves eth0 eth1 | |
| 1562 | − bond-mode active-backup | |
| 1563 | − bond-miimon 100 | |
| 1564 | − bond-primary eth0 eth1 | |
| 1594 | + auto bond0 | |
| 1595 | + iface bond0 inet dhcp | |
| 1596 | + bond-slaves eth0 eth1 | |
| 1597 | + bond-mode active-backup | |
| 1598 | + bond-miimon 100 | |
| 1599 | + bond-primary eth0 eth1 | |
| 1565 | 1600 | |
| 1566 | 1601 | If the above configuration doesn't work, you might have a system using |
| 1567 | 1602 | upstart for system startup. This is most notably true for recent |
| 1568 | 1603 | Ubuntu versions. The following stanza in /etc/network/interfaces will |
| 1569 | −produce the same result on those systems. | |
| 1570 | − | |
| 1571 | −auto bond0 | |
| 1572 | −iface bond0 inet dhcp | |
| 1573 | − bond-slaves none | |
| 1574 | − bond-mode active-backup | |
| 1575 | − bond-miimon 100 | |
| 1576 | − | |
| 1577 | −auto eth0 | |
| 1578 | −iface eth0 inet manual | |
| 1579 | − bond-master bond0 | |
| 1580 | − bond-primary eth0 eth1 | |
| 1581 | − | |
| 1582 | −auto eth1 | |
| 1583 | −iface eth1 inet manual | |
| 1584 | − bond-master bond0 | |
| 1585 | − bond-primary eth0 eth1 | |
| 1586 | − | |
| 1587 | −For a full list of bond-* supported options in /etc/network/interfaces and some | |
| 1588 | −more advanced examples tailored to you particular distros, see the files in | |
| 1604 | +produce the same result on those systems:: | |
| 1605 | + | |
| 1606 | + auto bond0 | |
| 1607 | + iface bond0 inet dhcp | |
| 1608 | + bond-slaves none | |
| 1609 | + bond-mode active-backup | |
| 1610 | + bond-miimon 100 | |
| 1611 | + | |
| 1612 | + auto eth0 | |
| 1613 | + iface eth0 inet manual | |
| 1614 | + bond-master bond0 | |
| 1615 | + bond-primary eth0 eth1 | |
| 1616 | + | |
| 1617 | + auto eth1 | |
| 1618 | + iface eth1 inet manual | |
| 1619 | + bond-master bond0 | |
| 1620 | + bond-primary eth0 eth1 | |
| 1621 | + | |
| 1622 | +For a full list of ``bond-*`` supported options in /etc/network/interfaces and | |
| 1623 | +some more advanced examples tailored to you particular distros, see the files in | |
| 1589 | 1624 | /usr/share/doc/ifenslave-2.6. |
| 1590 | 1625 | |
| 1591 | 1626 | 3.6 Overriding Configuration for Special Cases |
| @@ -1604,37 +1639,37 @@ can safely be sent over either interface. Such configurations may be achieved · 12 unmodified lines | ||
| 1604 | 1639 | using the traffic control utilities inherent in linux. |
| 1605 | 1640 | |
| 1606 | 1641 | By default the bonding driver is multiqueue aware and 16 queues are created |
| 1607 | −when the driver initializes (see Documentation/networking/multiqueue.txt | |
| 1642 | +when the driver initializes (see Documentation/networking/multiqueue.rst | |
| 1608 | 1643 | for details). If more or less queues are desired the module parameter |
| 1609 | 1644 | tx_queues can be used to change this value. There is no sysfs parameter |
| 1610 | 1645 | available as the allocation is done at module init time. |
| 1611 | 1646 | |
| 1612 | 1647 | The output of the file /proc/net/bonding/bondX has changed so the output Queue |
| 1613 | −ID is now printed for each slave: | |
| 1648 | +ID is now printed for each slave:: | |
| 1614 | 1649 | |
| 1615 | −Bonding Mode: fault-tolerance (active-backup) | |
| 1616 | −Primary Slave: None | |
| 1617 | −Currently Active Slave: eth0 | |
| 1618 | −MII Status: up | |
| 1619 | −MII Polling Interval (ms): 0 | |
| 1620 | −Up Delay (ms): 0 | |
| 1621 | −Down Delay (ms): 0 | |
| 1650 | + Bonding Mode: fault-tolerance (active-backup) | |
| 1651 | + Primary Slave: None | |
| 1652 | + Currently Active Slave: eth0 | |
| 1653 | + MII Status: up | |
| 1654 | + MII Polling Interval (ms): 0 | |
| 1655 | + Up Delay (ms): 0 | |
| 1656 | + Down Delay (ms): 0 | |
| 1622 | 1657 | |
| 1623 | −Slave Interface: eth0 | |
| 1624 | −MII Status: up | |
| 1625 | −Link Failure Count: 0 | |
| 1626 | −Permanent HW addr: 00:1a:a0:12:8f:cb | |
| 1627 | −Slave queue ID: 0 | |
| 1658 | + Slave Interface: eth0 | |
| 1659 | + MII Status: up | |
| 1660 | + Link Failure Count: 0 | |
| 1661 | + Permanent HW addr: 00:1a:a0:12:8f:cb | |
| 1662 | + Slave queue ID: 0 | |
| 1628 | 1663 | |
| 1629 | −Slave Interface: eth1 | |
| 1630 | −MII Status: up | |
| 1631 | −Link Failure Count: 0 | |
| 1632 | −Permanent HW addr: 00:1a:a0:12:8f:cc | |
| 1633 | −Slave queue ID: 2 | |
| 1664 | + Slave Interface: eth1 | |
| 1665 | + MII Status: up | |
| 1666 | + Link Failure Count: 0 | |
| 1667 | + Permanent HW addr: 00:1a:a0:12:8f:cc | |
| 1668 | + Slave queue ID: 2 | |
| 1634 | 1669 | |
| 1635 | −The queue_id for a slave can be set using the command: | |
| 1670 | +The queue_id for a slave can be set using the command:: | |
| 1636 | 1671 | |
| 1637 | −# echo "eth1:2" > /sys/class/net/bond0/bonding/queue_id | |
| 1672 | + # echo "eth1:2" > /sys/class/net/bond0/bonding/queue_id | |
| 1638 | 1673 | |
| 1639 | 1674 | Any interface that needs a queue_id set should set it with multiple calls |
| 1640 | 1675 | like the one above until proper priorities are set for all interfaces. On |
| @@ -1645,12 +1680,12 @@ These queue id's can be used in conjunction with the tc utility to configure · 4 unmodified lines | ||
| 1645 | 1680 | a multiqueue qdisc and filters to bias certain traffic to transmit on certain |
| 1646 | 1681 | slave devices. For instance, say we wanted, in the above configuration to |
| 1647 | 1682 | force all traffic bound to 192.168.1.100 to use eth1 in the bond as its output |
| 1648 | −device. The following commands would accomplish this: | |
| 1683 | +device. The following commands would accomplish this:: | |
| 1649 | 1684 | |
| 1650 | −# tc qdisc add dev bond0 handle 1 root multiq | |
| 1685 | + # tc qdisc add dev bond0 handle 1 root multiq | |
| 1651 | 1686 | |
| 1652 | −# tc filter add dev bond0 protocol ip parent 1: prio 1 u32 match ip dst \ | |
| 1653 | − 192.168.1.100 action skbedit queue_mapping 2 | |
| 1687 | + # tc filter add dev bond0 protocol ip parent 1: prio 1 u32 match ip \ | |
| 1688 | + dst 192.168.1.100 action skbedit queue_mapping 2 | |
| 1654 | 1689 | |
| 1655 | 1690 | These commands tell the kernel to attach a multiqueue queue discipline to the |
| 1656 | 1691 | bond0 interface and filter traffic enqueued to it, such that packets with a dst |
| @@ -1663,7 +1698,7 @@ that normal output policy selection should take place. One benefit to simply · 6 unmodified lines | ||
| 1663 | 1698 | leaving the qid for a slave to 0 is the multiqueue awareness in the bonding |
| 1664 | 1699 | driver that is now present. This awareness allows tc filters to be placed on |
| 1665 | 1700 | slave devices as well as bond devices and the bonding driver will simply act as |
| 1666 | −a pass-through for selecting output queues on the slave device rather than | |
| 1701 | +a pass-through for selecting output queues on the slave device rather than | |
| 1667 | 1702 | output port selection. |
| 1668 | 1703 | |
| 1669 | 1704 | This feature first appeared in bonding driver version 3.7.0 and support for |
| @@ -1689,31 +1724,31 @@ few bonding parameters: · 19 unmodified lines | ||
| 1689 | 1724 | (a) ad_actor_system : You can set a random mac-address that can be used for |
| 1690 | 1725 | these LACPDU exchanges. The value can not be either NULL or Multicast. |
| 1691 | 1726 | Also it's preferable to set the local-admin bit. Following shell code |
| 1692 | − generates a random mac-address as described above. | |
| 1727 | + generates a random mac-address as described above:: | |
| 1693 | 1728 | |
| 1694 | − # sys_mac_addr=$(printf '%02x:%02x:%02x:%02x:%02x:%02x' \ | |
| 1695 | − $(( (RANDOM & 0xFE) | 0x02 )) \ | |
| 1696 | − $(( RANDOM & 0xFF )) \ | |
| 1697 | − $(( RANDOM & 0xFF )) \ | |
| 1698 | − $(( RANDOM & 0xFF )) \ | |
| 1699 | − $(( RANDOM & 0xFF )) \ | |
| 1700 | − $(( RANDOM & 0xFF ))) | |
| 1701 | − # echo $sys_mac_addr > /sys/class/net/bond0/bonding/ad_actor_system | |
| 1729 | + # sys_mac_addr=$(printf '%02x:%02x:%02x:%02x:%02x:%02x' \ | |
| 1730 | + $(( (RANDOM & 0xFE) | 0x02 )) \ | |
| 1731 | + $(( RANDOM & 0xFF )) \ | |
| 1732 | + $(( RANDOM & 0xFF )) \ | |
| 1733 | + $(( RANDOM & 0xFF )) \ | |
| 1734 | + $(( RANDOM & 0xFF )) \ | |
| 1735 | + $(( RANDOM & 0xFF ))) | |
| 1736 | + # echo $sys_mac_addr > /sys/class/net/bond0/bonding/ad_actor_system | |
| 1702 | 1737 | |
| 1703 | 1738 | (b) ad_actor_sys_prio : Randomize the system priority. The default value |
| 1704 | 1739 | is 65535, but system can take the value from 1 - 65535. Following shell |
| 1705 | − code generates random priority and sets it. | |
| 1740 | + code generates random priority and sets it:: | |
| 1706 | 1741 | |
| 1707 | − # sys_prio=$(( 1 + RANDOM + RANDOM )) | |
| 1708 | − # echo $sys_prio > /sys/class/net/bond0/bonding/ad_actor_sys_prio | |
| 1742 | + # sys_prio=$(( 1 + RANDOM + RANDOM )) | |
| 1743 | + # echo $sys_prio > /sys/class/net/bond0/bonding/ad_actor_sys_prio | |
| 1709 | 1744 | |
| 1710 | 1745 | (c) ad_user_port_key : Use the user portion of the port-key. The default |
| 1711 | 1746 | keeps this empty. These are the upper 10 bits of the port-key and value |
| 1712 | 1747 | ranges from 0 - 1023. Following shell code generates these 10 bits and |
| 1713 | − sets it. | |
| 1748 | + sets it:: | |
| 1714 | 1749 | |
| 1715 | − # usr_port_key=$(( RANDOM & 0x3FF )) | |
| 1716 | − # echo $usr_port_key > /sys/class/net/bond0/bonding/ad_user_port_key | |
| 1750 | + # usr_port_key=$(( RANDOM & 0x3FF )) | |
| 1751 | + # echo $usr_port_key > /sys/class/net/bond0/bonding/ad_user_port_key | |
| 1717 | 1752 | |
| 1718 | 1753 | |
| 1719 | 1754 | 4 Querying Bonding Configuration |
| @@ -1722,81 +1757,81 @@ few bonding parameters: · 2 unmodified lines | ||
| 1722 | 1757 | 4.1 Bonding Configuration |
| 1723 | 1758 | ------------------------- |
| 1724 | 1759 | |
| 1725 | − Each bonding device has a read-only file residing in the | |
| 1760 | +Each bonding device has a read-only file residing in the | |
| 1726 | 1761 | /proc/net/bonding directory. The file contents include information |
| 1727 | 1762 | about the bonding configuration, options and state of each slave. |
| 1728 | 1763 | |
| 1729 | − For example, the contents of /proc/net/bonding/bond0 after the | |
| 1764 | +For example, the contents of /proc/net/bonding/bond0 after the | |
| 1730 | 1765 | driver is loaded with parameters of mode=0 and miimon=1000 is |
| 1731 | −generally as follows: | |
| 1766 | +generally as follows:: | |
| 1732 | 1767 | |
| 1733 | 1768 | Ethernet Channel Bonding Driver: 2.6.1 (October 29, 2004) |
| 1734 | − Bonding Mode: load balancing (round-robin) | |
| 1735 | − Currently Active Slave: eth0 | |
| 1736 | − MII Status: up | |
| 1737 | − MII Polling Interval (ms): 1000 | |
| 1738 | − Up Delay (ms): 0 | |
| 1739 | − Down Delay (ms): 0 | |
| 1740 | − | |
| 1741 | − Slave Interface: eth1 | |
| 1742 | − MII Status: up | |
| 1743 | − Link Failure Count: 1 | |
| 1744 | − | |
| 1745 | − Slave Interface: eth0 | |
| 1746 | − MII Status: up | |
| 1747 | − Link Failure Count: 1 | |
| 1748 | − | |
| 1749 | − The precise format and contents will change depending upon the | |
| 1769 | + Bonding Mode: load balancing (round-robin) | |
| 1770 | + Currently Active Slave: eth0 | |
| 1771 | + MII Status: up | |
| 1772 | + MII Polling Interval (ms): 1000 | |
| 1773 | + Up Delay (ms): 0 | |
| 1774 | + Down Delay (ms): 0 | |
| 1775 | + | |
| 1776 | + Slave Interface: eth1 | |
| 1777 | + MII Status: up | |
| 1778 | + Link Failure Count: 1 | |
| 1779 | + | |
| 1780 | + Slave Interface: eth0 | |
| 1781 | + MII Status: up | |
| 1782 | + Link Failure Count: 1 | |
| 1783 | + | |
| 1784 | +The precise format and contents will change depending upon the | |
| 1750 | 1785 | bonding configuration, state, and version of the bonding driver. |
| 1751 | 1786 | |
| 1752 | 1787 | 4.2 Network configuration |
| 1753 | 1788 | ------------------------- |
| 1754 | 1789 | |
| 1755 | − The network configuration can be inspected using the ifconfig | |
| 1790 | +The network configuration can be inspected using the ifconfig | |
| 1756 | 1791 | command. Bonding devices will have the MASTER flag set; Bonding slave |
| 1757 | 1792 | devices will have the SLAVE flag set. The ifconfig output does not |
| 1758 | 1793 | contain information on which slaves are associated with which masters. |
| 1759 | 1794 | |
| 1760 | − In the example below, the bond0 interface is the master | |
| 1795 | +In the example below, the bond0 interface is the master | |
| 1761 | 1796 | (MASTER) while eth0 and eth1 are slaves (SLAVE). Notice all slaves of |
| 1762 | 1797 | bond0 have the same MAC address (HWaddr) as bond0 for all modes except |
| 1763 | −TLB and ALB that require a unique MAC address for each slave. | |
| 1764 | − | |
| 1765 | −# /sbin/ifconfig | |
| 1766 | −bond0 Link encap:Ethernet HWaddr 00:C0:F0:1F:37:B4 | |
| 1767 | − inet addr:XXX.XXX.XXX.YYY Bcast:XXX.XXX.XXX.255 Mask:255.255.252.0 | |
| 1768 | − UP BROADCAST RUNNING MASTER MULTICAST MTU:1500 Metric:1 | |
| 1769 | − RX packets:7224794 errors:0 dropped:0 overruns:0 frame:0 | |
| 1770 | − TX packets:3286647 errors:1 dropped:0 overruns:1 carrier:0 | |
| 1771 | − collisions:0 txqueuelen:0 | |
| 1772 | − | |
| 1773 | −eth0 Link encap:Ethernet HWaddr 00:C0:F0:1F:37:B4 | |
| 1774 | − UP BROADCAST RUNNING SLAVE MULTICAST MTU:1500 Metric:1 | |
| 1775 | − RX packets:3573025 errors:0 dropped:0 overruns:0 frame:0 | |
| 1776 | − TX packets:1643167 errors:1 dropped:0 overruns:1 carrier:0 | |
| 1777 | − collisions:0 txqueuelen:100 | |
| 1778 | − Interrupt:10 Base address:0x1080 | |
| 1779 | − | |
| 1780 | −eth1 Link encap:Ethernet HWaddr 00:C0:F0:1F:37:B4 | |
| 1781 | − UP BROADCAST RUNNING SLAVE MULTICAST MTU:1500 Metric:1 | |
| 1782 | − RX packets:3651769 errors:0 dropped:0 overruns:0 frame:0 | |
| 1783 | − TX packets:1643480 errors:0 dropped:0 overruns:0 carrier:0 | |
| 1784 | − collisions:0 txqueuelen:100 | |
| 1785 | − Interrupt:9 Base address:0x1400 | |
| 1798 | +TLB and ALB that require a unique MAC address for each slave:: | |
| 1799 | + | |
| 1800 | + # /sbin/ifconfig | |
| 1801 | + bond0 Link encap:Ethernet HWaddr 00:C0:F0:1F:37:B4 | |
| 1802 | + inet addr:XXX.XXX.XXX.YYY Bcast:XXX.XXX.XXX.255 Mask:255.255.252.0 | |
| 1803 | + UP BROADCAST RUNNING MASTER MULTICAST MTU:1500 Metric:1 | |
| 1804 | + RX packets:7224794 errors:0 dropped:0 overruns:0 frame:0 | |
| 1805 | + TX packets:3286647 errors:1 dropped:0 overruns:1 carrier:0 | |
| 1806 | + collisions:0 txqueuelen:0 | |
| 1807 | + | |
| 1808 | + eth0 Link encap:Ethernet HWaddr 00:C0:F0:1F:37:B4 | |
| 1809 | + UP BROADCAST RUNNING SLAVE MULTICAST MTU:1500 Metric:1 | |
| 1810 | + RX packets:3573025 errors:0 dropped:0 overruns:0 frame:0 | |
| 1811 | + TX packets:1643167 errors:1 dropped:0 overruns:1 carrier:0 | |
| 1812 | + collisions:0 txqueuelen:100 | |
| 1813 | + Interrupt:10 Base address:0x1080 | |
| 1814 | + | |
| 1815 | + eth1 Link encap:Ethernet HWaddr 00:C0:F0:1F:37:B4 | |
| 1816 | + UP BROADCAST RUNNING SLAVE MULTICAST MTU:1500 Metric:1 | |
| 1817 | + RX packets:3651769 errors:0 dropped:0 overruns:0 frame:0 | |
| 1818 | + TX packets:1643480 errors:0 dropped:0 overruns:0 carrier:0 | |
| 1819 | + collisions:0 txqueuelen:100 | |
| 1820 | + Interrupt:9 Base address:0x1400 | |
| 1786 | 1821 | |
| 1787 | 1822 | 5. Switch Configuration |
| 1788 | 1823 | ======================= |
| 1789 | 1824 | |
| 1790 | − For this section, "switch" refers to whatever system the | |
| 1825 | +For this section, "switch" refers to whatever system the | |
| 1791 | 1826 | bonded devices are directly connected to (i.e., where the other end of |
| 1792 | 1827 | the cable plugs into). This may be an actual dedicated switch device, |
| 1793 | 1828 | or it may be another regular system (e.g., another computer running |
| 1794 | 1829 | Linux), |
| 1795 | 1830 | |
| 1796 | − The active-backup, balance-tlb and balance-alb modes do not | |
| 1831 | +The active-backup, balance-tlb and balance-alb modes do not | |
| 1797 | 1832 | require any specific configuration of the switch. |
| 1798 | 1833 | |
| 1799 | − The 802.3ad mode requires that the switch have the appropriate | |
| 1834 | +The 802.3ad mode requires that the switch have the appropriate | |
| 1800 | 1835 | ports configured as an 802.3ad aggregation. The precise method used |
| 1801 | 1836 | to configure this varies from switch to switch, but, for example, a |
| 1802 | 1837 | Cisco 3550 series switch requires that the appropriate ports first be |
| @@ -1804,7 +1839,7 @@ grouped together in a single etherchannel instance, then that · 1 unmodified line | ||
| 1804 | 1839 | etherchannel is set to mode "lacp" to enable 802.3ad (instead of |
| 1805 | 1840 | standard EtherChannel). |
| 1806 | 1841 | |
| 1807 | − The balance-rr, balance-xor and broadcast modes generally | |
| 1842 | +The balance-rr, balance-xor and broadcast modes generally | |
| 1808 | 1843 | require that the switch have the appropriate ports grouped together. |
| 1809 | 1844 | The nomenclature for such a group differs between switches, it may be |
| 1810 | 1845 | called an "etherchannel" (as in the Cisco example, above), a "trunk |
| @@ -1820,7 +1855,7 @@ with another EtherChannel group. · 9 unmodified lines | ||
| 1820 | 1855 | 6. 802.1q VLAN Support |
| 1821 | 1856 | ====================== |
| 1822 | 1857 | |
| 1823 | − It is possible to configure VLAN devices over a bond interface | |
| 1858 | +It is possible to configure VLAN devices over a bond interface | |
| 1824 | 1859 | using the 8021q driver. However, only packets coming from the 8021q |
| 1825 | 1860 | driver and passing through bonding will be tagged by default. Self |
| 1826 | 1861 | generated packets, for example, bonding's learning packets or ARP |
| @@ -1829,7 +1864,7 @@ tagged internally by bonding itself. As a result, bonding must · 2 unmodified lines | ||
| 1829 | 1864 | "learn" the VLAN IDs configured above it, and use those IDs to tag |
| 1830 | 1865 | self generated packets. |
| 1831 | 1866 | |
| 1832 | − For reasons of simplicity, and to support the use of adapters | |
| 1867 | +For reasons of simplicity, and to support the use of adapters | |
| 1833 | 1868 | that can do VLAN hardware acceleration offloading, the bonding |
| 1834 | 1869 | interface declares itself as fully hardware offloading capable, it gets |
| 1835 | 1870 | the add_vid/kill_vid notifications to gather the necessary |
| @@ -1839,7 +1874,7 @@ should go through an adapter that is not offloading capable are · 3 unmodified lines | ||
| 1839 | 1874 | "un-accelerated" by the bonding driver so the VLAN tag sits in the |
| 1840 | 1875 | regular location. |
| 1841 | 1876 | |
| 1842 | − VLAN interfaces *must* be added on top of a bonding interface | |
| 1877 | +VLAN interfaces *must* be added on top of a bonding interface | |
| 1843 | 1878 | only after enslaving at least one slave. The bonding interface has a |
| 1844 | 1879 | hardware address of 00:00:00:00:00:00 until the first slave is added. |
| 1845 | 1880 | If the VLAN interface is created prior to the first enslavement, it |
| @@ -1847,23 +1882,23 @@ would pick up the all-zeroes hardware address. Once the first slave · 1 unmodified line | ||
| 1847 | 1882 | is attached to the bond, the bond device itself will pick up the |
| 1848 | 1883 | slave's hardware address, which is then available for the VLAN device. |
| 1849 | 1884 | |
| 1850 | − Also, be aware that a similar problem can occur if all slaves | |
| 1885 | +Also, be aware that a similar problem can occur if all slaves | |
| 1851 | 1886 | are released from a bond that still has one or more VLAN interfaces on |
| 1852 | 1887 | top of it. When a new slave is added, the bonding interface will |
| 1853 | 1888 | obtain its hardware address from the first slave, which might not |
| 1854 | 1889 | match the hardware address of the VLAN interfaces (which was |
| 1855 | 1890 | ultimately copied from an earlier slave). |
| 1856 | 1891 | |
| 1857 | − There are two methods to insure that the VLAN device operates | |
| 1892 | +There are two methods to insure that the VLAN device operates | |
| 1858 | 1893 | with the correct hardware address if all slaves are removed from a |
| 1859 | 1894 | bond interface: |
| 1860 | 1895 | |
| 1861 | − 1. Remove all VLAN interfaces then recreate them | |
| 1896 | +1. Remove all VLAN interfaces then recreate them | |
| 1862 | 1897 | |
| 1863 | − 2. Set the bonding interface's hardware address so that it | |
| 1898 | +2. Set the bonding interface's hardware address so that it | |
| 1864 | 1899 | matches the hardware address of the VLAN interfaces. |
| 1865 | 1900 | |
| 1866 | − Note that changing a VLAN interface's HW address would set the | |
| 1901 | +Note that changing a VLAN interface's HW address would set the | |
| 1867 | 1902 | underlying device -- i.e. the bonding interface -- to promiscuous |
| 1868 | 1903 | mode, which might not be what you want. |
| 1869 | 1904 | |
| @@ -1871,24 +1906,24 @@ mode, which might not be what you want. · 1 unmodified line | ||
| 1871 | 1906 | 7. Link Monitoring |
| 1872 | 1907 | ================== |
| 1873 | 1908 | |
| 1874 | − The bonding driver at present supports two schemes for | |
| 1909 | +The bonding driver at present supports two schemes for | |
| 1875 | 1910 | monitoring a slave device's link state: the ARP monitor and the MII |
| 1876 | 1911 | monitor. |
| 1877 | 1912 | |
| 1878 | − At the present time, due to implementation restrictions in the | |
| 1913 | +At the present time, due to implementation restrictions in the | |
| 1879 | 1914 | bonding driver itself, it is not possible to enable both ARP and MII |
| 1880 | 1915 | monitoring simultaneously. |
| 1881 | 1916 | |
| 1882 | 1917 | 7.1 ARP Monitor Operation |
| 1883 | 1918 | ------------------------- |
| 1884 | 1919 | |
| 1885 | − The ARP monitor operates as its name suggests: it sends ARP | |
| 1920 | +The ARP monitor operates as its name suggests: it sends ARP | |
| 1886 | 1921 | queries to one or more designated peer systems on the network, and |
| 1887 | 1922 | uses the response as an indication that the link is operating. This |
| 1888 | 1923 | gives some assurance that traffic is actually flowing to and from one |
| 1889 | 1924 | or more peers on the local network. |
| 1890 | 1925 | |
| 1891 | − The ARP monitor relies on the device driver itself to verify | |
| 1926 | +The ARP monitor relies on the device driver itself to verify | |
| 1892 | 1927 | that traffic is flowing. In particular, the driver must keep up to |
| 1893 | 1928 | date the last receive time, dev->last_rx. Drivers that use NETIF_F_LLTX |
| 1894 | 1929 | flag must also update netdev_queue->trans_start. If they do not, then the |
| @@ -1900,36 +1935,36 @@ your device driver is not updating last_rx and trans_start. · 5 unmodified lines | ||
| 1900 | 1935 | 7.2 Configuring Multiple ARP Targets |
| 1901 | 1936 | ------------------------------------ |
| 1902 | 1937 | |
| 1903 | − While ARP monitoring can be done with just one target, it can | |
| 1938 | +While ARP monitoring can be done with just one target, it can | |
| 1904 | 1939 | be useful in a High Availability setup to have several targets to |
| 1905 | 1940 | monitor. In the case of just one target, the target itself may go |
| 1906 | 1941 | down or have a problem making it unresponsive to ARP requests. Having |
| 1907 | 1942 | an additional target (or several) increases the reliability of the ARP |
| 1908 | 1943 | monitoring. |
| 1909 | 1944 | |
| 1910 | − Multiple ARP targets must be separated by commas as follows: | |
| 1945 | +Multiple ARP targets must be separated by commas as follows:: | |
| 1911 | 1946 | |
| 1912 | −# example options for ARP monitoring with three targets | |
| 1913 | −alias bond0 bonding | |
| 1914 | −options bond0 arp_interval=60 arp_ip_target=192.168.0.1,192.168.0.3,192.168.0.9 | |
| 1947 | + # example options for ARP monitoring with three targets | |
| 1948 | + alias bond0 bonding | |
| 1949 | + options bond0 arp_interval=60 arp_ip_target=192.168.0.1,192.168.0.3,192.168.0.9 | |
| 1915 | 1950 | |
| 1916 | − For just a single target the options would resemble: | |
| 1951 | +For just a single target the options would resemble:: | |
| 1917 | 1952 | |
| 1918 | −# example options for ARP monitoring with one target | |
| 1919 | −alias bond0 bonding | |
| 1920 | −options bond0 arp_interval=60 arp_ip_target=192.168.0.100 | |
| 1953 | + # example options for ARP monitoring with one target | |
| 1954 | + alias bond0 bonding | |
| 1955 | + options bond0 arp_interval=60 arp_ip_target=192.168.0.100 | |
| 1921 | 1956 | |
| 1922 | 1957 | |
| 1923 | 1958 | 7.3 MII Monitor Operation |
| 1924 | 1959 | ------------------------- |
| 1925 | 1960 | |
| 1926 | − The MII monitor monitors only the carrier state of the local | |
| 1961 | +The MII monitor monitors only the carrier state of the local | |
| 1927 | 1962 | network interface. It accomplishes this in one of three ways: by |
| 1928 | 1963 | depending upon the device driver to maintain its carrier state, by |
| 1929 | 1964 | querying the device's MII registers, or by making an ethtool query to |
| 1930 | 1965 | the device. |
| 1931 | 1966 | |
| 1932 | − If the use_carrier module parameter is 1 (the default value), | |
| 1967 | +If the use_carrier module parameter is 1 (the default value), | |
| 1933 | 1968 | then the MII monitor will rely on the driver for carrier state |
| 1934 | 1969 | information (via the netif_carrier subsystem). As explained in the |
| 1935 | 1970 | use_carrier parameter information, above, if the MII monitor fails to |
| @@ -1937,7 +1972,7 @@ detect carrier loss on the device (e.g., when the cable is physically · 1 unmodified line | ||
| 1937 | 1972 | disconnected), it may be that the driver does not support |
| 1938 | 1973 | netif_carrier. |
| 1939 | 1974 | |
| 1940 | − If use_carrier is 0, then the MII monitor will first query the | |
| 1975 | +If use_carrier is 0, then the MII monitor will first query the | |
| 1941 | 1976 | device's (via ioctl) MII registers and check the link state. If that |
| 1942 | 1977 | request fails (not just that it returns carrier down), then the MII |
| 1943 | 1978 | monitor will make an ethtool ETHOOL_GLINK request to attempt to obtain |
| @@ -1952,25 +1987,25 @@ up. · 8 unmodified lines | ||
| 1952 | 1987 | 8.1 Adventures in Routing |
| 1953 | 1988 | ------------------------- |
| 1954 | 1989 | |
| 1955 | − When bonding is configured, it is important that the slave | |
| 1990 | +When bonding is configured, it is important that the slave | |
| 1956 | 1991 | devices not have routes that supersede routes of the master (or, |
| 1957 | 1992 | generally, not have routes at all). For example, suppose the bonding |
| 1958 | 1993 | device bond0 has two slaves, eth0 and eth1, and the routing table is |
| 1959 | −as follows: | |
| 1994 | +as follows:: | |
| 1960 | 1995 | |
| 1961 | −Kernel IP routing table | |
| 1962 | −Destination Gateway Genmask Flags MSS Window irtt Iface | |
| 1963 | −10.0.0.0 0.0.0.0 255.255.0.0 U 40 0 0 eth0 | |
| 1964 | −10.0.0.0 0.0.0.0 255.255.0.0 U 40 0 0 eth1 | |
| 1965 | −10.0.0.0 0.0.0.0 255.255.0.0 U 40 0 0 bond0 | |
| 1966 | −127.0.0.0 0.0.0.0 255.0.0.0 U 40 0 0 lo | |
| 1996 | + Kernel IP routing table | |
| 1997 | + Destination Gateway Genmask Flags MSS Window irtt Iface | |
| 1998 | + 10.0.0.0 0.0.0.0 255.255.0.0 U 40 0 0 eth0 | |
| 1999 | + 10.0.0.0 0.0.0.0 255.255.0.0 U 40 0 0 eth1 | |
| 2000 | + 10.0.0.0 0.0.0.0 255.255.0.0 U 40 0 0 bond0 | |
| 2001 | + 127.0.0.0 0.0.0.0 255.0.0.0 U 40 0 0 lo | |
| 1967 | 2002 | |
| 1968 | − This routing configuration will likely still update the | |
| 2003 | +This routing configuration will likely still update the | |
| 1969 | 2004 | receive/transmit times in the driver (needed by the ARP monitor), but |
| 1970 | 2005 | may bypass the bonding driver (because outgoing traffic to, in this |
| 1971 | 2006 | case, another host on network 10 would use eth0 or eth1 before bond0). |
| 1972 | 2007 | |
| 1973 | − The ARP monitor (and ARP itself) may become confused by this | |
| 2008 | +The ARP monitor (and ARP itself) may become confused by this | |
| 1974 | 2009 | configuration, because ARP requests (generated by the ARP monitor) |
| 1975 | 2010 | will be sent on one interface (bond0), but the corresponding reply |
| 1976 | 2011 | will arrive on a different interface (eth0). This reply looks to ARP |
| @@ -1978,7 +2013,7 @@ as an unsolicited ARP reply (because ARP matches replies on an · 1 unmodified line | ||
| 1978 | 2013 | interface basis), and is discarded. The MII monitor is not affected |
| 1979 | 2014 | by the state of the routing table. |
| 1980 | 2015 | |
| 1981 | − The solution here is simply to insure that slaves do not have | |
| 2016 | +The solution here is simply to insure that slaves do not have | |
| 1982 | 2017 | routes of their own, and if for some reason they must, those routes do |
| 1983 | 2018 | not supersede routes of their master. This should generally be the |
| 1984 | 2019 | case, but unusual configurations or errant manual or automatic static |
| @@ -1987,22 +2022,22 @@ route additions may cause trouble. · 2 unmodified lines | ||
| 1987 | 2022 | 8.2 Ethernet Device Renaming |
| 1988 | 2023 | ---------------------------- |
| 1989 | 2024 | |
| 1990 | − On systems with network configuration scripts that do not | |
| 2025 | +On systems with network configuration scripts that do not | |
| 1991 | 2026 | associate physical devices directly with network interface names (so |
| 1992 | 2027 | that the same physical device always has the same "ethX" name), it may |
| 1993 | 2028 | be necessary to add some special logic to config files in |
| 1994 | 2029 | /etc/modprobe.d/. |
| 1995 | 2030 | |
| 1996 | − For example, given a modules.conf containing the following: | |
| 2031 | +For example, given a modules.conf containing the following:: | |
| 1997 | 2032 | |
| 1998 | −alias bond0 bonding | |
| 1999 | −options bond0 mode=some-mode miimon=50 | |
| 2000 | −alias eth0 tg3 | |
| 2001 | −alias eth1 tg3 | |
| 2002 | −alias eth2 e1000 | |
| 2003 | −alias eth3 e1000 | |
| 2033 | + alias bond0 bonding | |
| 2034 | + options bond0 mode=some-mode miimon=50 | |
| 2035 | + alias eth0 tg3 | |
| 2036 | + alias eth1 tg3 | |
| 2037 | + alias eth2 e1000 | |
| 2038 | + alias eth3 e1000 | |
| 2004 | 2039 | |
| 2005 | − If neither eth0 and eth1 are slaves to bond0, then when the | |
| 2040 | +If neither eth0 and eth1 are slaves to bond0, then when the | |
| 2006 | 2041 | bond0 interface comes up, the devices may end up reordered. This |
| 2007 | 2042 | happens because bonding is loaded first, then its slave device's |
| 2008 | 2043 | drivers are loaded next. Since no other drivers have been loaded, |
| @@ -2010,36 +2045,36 @@ when the e1000 driver loads, it will receive eth0 and eth1 for its · 1 unmodified line | ||
| 2010 | 2045 | devices, but the bonding configuration tries to enslave eth2 and eth3 |
| 2011 | 2046 | (which may later be assigned to the tg3 devices). |
| 2012 | 2047 | |
| 2013 | − Adding the following: | |
| 2048 | +Adding the following:: | |
| 2014 | 2049 | |
| 2015 | −add above bonding e1000 tg3 | |
| 2050 | + add above bonding e1000 tg3 | |
| 2016 | 2051 | |
| 2017 | − causes modprobe to load e1000 then tg3, in that order, when | |
| 2052 | +causes modprobe to load e1000 then tg3, in that order, when | |
| 2018 | 2053 | bonding is loaded. This command is fully documented in the |
| 2019 | 2054 | modules.conf manual page. |
| 2020 | 2055 | |
| 2021 | − On systems utilizing modprobe an equivalent problem can occur. | |
| 2056 | +On systems utilizing modprobe an equivalent problem can occur. | |
| 2022 | 2057 | In this case, the following can be added to config files in |
| 2023 | −/etc/modprobe.d/ as: | |
| 2058 | +/etc/modprobe.d/ as:: | |
| 2024 | 2059 | |
| 2025 | −softdep bonding pre: tg3 e1000 | |
| 2060 | + softdep bonding pre: tg3 e1000 | |
| 2026 | 2061 | |
| 2027 | − This will load tg3 and e1000 modules before loading the bonding one. | |
| 2062 | +This will load tg3 and e1000 modules before loading the bonding one. | |
| 2028 | 2063 | Full documentation on this can be found in the modprobe.d and modprobe |
| 2029 | 2064 | manual pages. |
| 2030 | 2065 | |
| 2031 | 2066 | 8.3. Painfully Slow Or No Failed Link Detection By Miimon |
| 2032 | 2067 | --------------------------------------------------------- |
| 2033 | 2068 | |
| 2034 | − By default, bonding enables the use_carrier option, which | |
| 2069 | +By default, bonding enables the use_carrier option, which | |
| 2035 | 2070 | instructs bonding to trust the driver to maintain carrier state. |
| 2036 | 2071 | |
| 2037 | − As discussed in the options section, above, some drivers do | |
| 2072 | +As discussed in the options section, above, some drivers do | |
| 2038 | 2073 | not support the netif_carrier_on/_off link state tracking system. |
| 2039 | 2074 | With use_carrier enabled, bonding will always see these links as up, |
| 2040 | 2075 | regardless of their actual state. |
| 2041 | 2076 | |
| 2042 | − Additionally, other drivers do support netif_carrier, but do | |
| 2077 | +Additionally, other drivers do support netif_carrier, but do | |
| 2043 | 2078 | not maintain it in real time, e.g., only polling the link state at |
| 2044 | 2079 | some fixed interval. In this case, miimon will detect failures, but |
| 2045 | 2080 | only after some long period of time has expired. If it appears that |
| @@ -2051,7 +2086,7 @@ use_carrier=0 method of querying the registers directly works). If · 5 unmodified lines | ||
| 2051 | 2086 | use_carrier=0 does not improve the failover, then the driver may cache |
| 2052 | 2087 | the registers, or the problem may be elsewhere. |
| 2053 | 2088 | |
| 2054 | − Also, remember that miimon only checks for the device's | |
| 2089 | +Also, remember that miimon only checks for the device's | |
| 2055 | 2090 | carrier state. It has no way to determine the state of devices on or |
| 2056 | 2091 | beyond other ports of a switch, or if a switch is refusing to pass |
| 2057 | 2092 | traffic while still maintaining carrier on. |
| @@ -2059,7 +2094,7 @@ traffic while still maintaining carrier on. · 1 unmodified line | ||
| 2059 | 2094 | 9. SNMP agents |
| 2060 | 2095 | =============== |
| 2061 | 2096 | |
| 2062 | − If running SNMP agents, the bonding driver should be loaded | |
| 2097 | +If running SNMP agents, the bonding driver should be loaded | |
| 2063 | 2098 | before any network drivers participating in a bond. This requirement |
| 2064 | 2099 | is due to the interface index (ipAdEntIfIndex) being associated to |
| 2065 | 2100 | the first interface found with a given IP address. That is, there is |
| @@ -2070,6 +2105,8 @@ with the eth0 interface. This configuration is shown below, the IP · 4 unmodified lines | ||
| 2070 | 2105 | address 192.168.1.1 has an interface index of 2 which indexes to eth0 |
| 2071 | 2106 | in the ifDescr table (ifDescr.2). |
| 2072 | 2107 | |
| 2108 | +:: | |
| 2109 | + | |
| 2073 | 2110 | interfaces.ifTable.ifEntry.ifDescr.1 = lo |
| 2074 | 2111 | interfaces.ifTable.ifEntry.ifDescr.2 = eth0 |
| 2075 | 2112 | interfaces.ifTable.ifEntry.ifDescr.3 = eth1 |
| @@ -2081,7 +2118,7 @@ in the ifDescr table (ifDescr.2). · 5 unmodified lines | ||
| 2081 | 2118 | ip.ipAddrTable.ipAddrEntry.ipAdEntIfIndex.10.74.20.94 = 4 |
| 2082 | 2119 | ip.ipAddrTable.ipAddrEntry.ipAdEntIfIndex.127.0.0.1 = 1 |
| 2083 | 2120 | |
| 2084 | − This problem is avoided by loading the bonding driver before | |
| 2121 | +This problem is avoided by loading the bonding driver before | |
| 2085 | 2122 | any network drivers participating in a bond. Below is an example of |
| 2086 | 2123 | loading the bonding driver first, the IP address 192.168.1.1 is |
| 2087 | 2124 | correctly associated with ifDescr.2. |
| @@ -2097,7 +2134,7 @@ correctly associated with ifDescr.2. · 9 unmodified lines | ||
| 2097 | 2134 | ip.ipAddrTable.ipAddrEntry.ipAdEntIfIndex.10.74.20.94 = 5 |
| 2098 | 2135 | ip.ipAddrTable.ipAddrEntry.ipAdEntIfIndex.127.0.0.1 = 1 |
| 2099 | 2136 | |
| 2100 | − While some distributions may not report the interface name in | |
| 2137 | +While some distributions may not report the interface name in | |
| 2101 | 2138 | ifDescr, the association between the IP address and IfIndex remains |
| 2102 | 2139 | and SNMP functions such as Interface_Scan_Next will report that |
| 2103 | 2140 | association. |
| @@ -2105,34 +2142,34 @@ association. · 1 unmodified line | ||
| 2105 | 2142 | 10. Promiscuous mode |
| 2106 | 2143 | ==================== |
| 2107 | 2144 | |
| 2108 | − When running network monitoring tools, e.g., tcpdump, it is | |
| 2145 | +When running network monitoring tools, e.g., tcpdump, it is | |
| 2109 | 2146 | common to enable promiscuous mode on the device, so that all traffic |
| 2110 | 2147 | is seen (instead of seeing only traffic destined for the local host). |
| 2111 | 2148 | The bonding driver handles promiscuous mode changes to the bonding |
| 2112 | 2149 | master device (e.g., bond0), and propagates the setting to the slave |
| 2113 | 2150 | devices. |
| 2114 | 2151 | |
| 2115 | − For the balance-rr, balance-xor, broadcast, and 802.3ad modes, | |
| 2152 | +For the balance-rr, balance-xor, broadcast, and 802.3ad modes, | |
| 2116 | 2153 | the promiscuous mode setting is propagated to all slaves. |
| 2117 | 2154 | |
| 2118 | − For the active-backup, balance-tlb and balance-alb modes, the | |
| 2155 | +For the active-backup, balance-tlb and balance-alb modes, the | |
| 2119 | 2156 | promiscuous mode setting is propagated only to the active slave. |
| 2120 | 2157 | |
| 2121 | − For balance-tlb mode, the active slave is the slave currently | |
| 2158 | +For balance-tlb mode, the active slave is the slave currently | |
| 2122 | 2159 | receiving inbound traffic. |
| 2123 | 2160 | |
| 2124 | − For balance-alb mode, the active slave is the slave used as a | |
| 2161 | +For balance-alb mode, the active slave is the slave used as a | |
| 2125 | 2162 | "primary." This slave is used for mode-specific control traffic, for |
| 2126 | 2163 | sending to peers that are unassigned or if the load is unbalanced. |
| 2127 | 2164 | |
| 2128 | − For the active-backup, balance-tlb and balance-alb modes, when | |
| 2165 | +For the active-backup, balance-tlb and balance-alb modes, when | |
| 2129 | 2166 | the active slave changes (e.g., due to a link failure), the |
| 2130 | 2167 | promiscuous setting will be propagated to the new active slave. |
| 2131 | 2168 | |
| 2132 | 2169 | 11. Configuring Bonding for High Availability |
| 2133 | 2170 | ============================================= |
| 2134 | 2171 | |
| 2135 | − High Availability refers to configurations that provide | |
| 2172 | +High Availability refers to configurations that provide | |
| 2136 | 2173 | maximum network availability by having redundant or backup devices, |
| 2137 | 2174 | links or switches between the host and the rest of the world. The |
| 2138 | 2175 | goal is to provide the maximum availability of network connectivity |
| @@ -2142,7 +2179,7 @@ could provide higher throughput. · 3 unmodified lines | ||
| 2142 | 2179 | 11.1 High Availability in a Single Switch Topology |
| 2143 | 2180 | -------------------------------------------------- |
| 2144 | 2181 | |
| 2145 | − If two hosts (or a host and a single switch) are directly | |
| 2182 | +If two hosts (or a host and a single switch) are directly | |
| 2146 | 2183 | connected via multiple physical links, then there is no availability |
| 2147 | 2184 | penalty to optimizing for maximum bandwidth. In this case, there is |
| 2148 | 2185 | only one switch (or peer), so if it fails, there is no alternative |
| @@ -2150,32 +2187,32 @@ access to fail over to. Additionally, the bonding load balance modes · 1 unmodified line | ||
| 2150 | 2187 | support link monitoring of their members, so if individual links fail, |
| 2151 | 2188 | the load will be rebalanced across the remaining devices. |
| 2152 | 2189 | |
| 2153 | − See Section 12, "Configuring Bonding for Maximum Throughput" | |
| 2190 | +See Section 12, "Configuring Bonding for Maximum Throughput" | |
| 2154 | 2191 | for information on configuring bonding with one peer device. |
| 2155 | 2192 | |
| 2156 | 2193 | 11.2 High Availability in a Multiple Switch Topology |
| 2157 | 2194 | ---------------------------------------------------- |
| 2158 | 2195 | |
| 2159 | − With multiple switches, the configuration of bonding and the | |
| 2196 | +With multiple switches, the configuration of bonding and the | |
| 2160 | 2197 | network changes dramatically. In multiple switch topologies, there is |
| 2161 | 2198 | a trade off between network availability and usable bandwidth. |
| 2162 | 2199 | |
| 2163 | − Below is a sample network, configured to maximize the | |
| 2164 | −availability of the network: | |
| 2165 | − | |
| 2166 | − | | | |
| 2167 | − |port3 port3| | |
| 2168 | − +-----+----+ +-----+----+ | |
| 2169 | − | |port2 ISL port2| | | |
| 2170 | − | switch A +--------------------------+ switch B | | |
| 2171 | − | | | | | |
| 2172 | − +-----+----+ +-----++---+ | |
| 2173 | − |port1 port1| | |
| 2174 | − | +-------+ | | |
| 2175 | − +-------------+ host1 +---------------+ | |
| 2176 | − eth0 +-------+ eth1 | |
| 2177 | − | |
| 2178 | − In this configuration, there is a link between the two | |
| 2200 | +Below is a sample network, configured to maximize the | |
| 2201 | +availability of the network:: | |
| 2202 | + | |
| 2203 | + | | | |
| 2204 | + |port3 port3| | |
| 2205 | + +-----+----+ +-----+----+ | |
| 2206 | + | |port2 ISL port2| | | |
| 2207 | + | switch A +--------------------------+ switch B | | |
| 2208 | + | | | | | |
| 2209 | + +-----+----+ +-----++---+ | |
| 2210 | + |port1 port1| | |
| 2211 | + | +-------+ | | |
| 2212 | + +-------------+ host1 +---------------+ | |
| 2213 | + eth0 +-------+ eth1 | |
| 2214 | + | |
| 2215 | +In this configuration, there is a link between the two | |
| 2179 | 2216 | switches (ISL, or inter switch link), and multiple ports connecting to |
| 2180 | 2217 | the outside world ("port3" on each switch). There is no technical |
| 2181 | 2218 | reason that this could not be extended to a third switch. |
| @@ -2183,19 +2220,21 @@ reason that this could not be extended to a third switch. · 1 unmodified line | ||
| 2183 | 2220 | 11.2.1 HA Bonding Mode Selection for Multiple Switch Topology |
| 2184 | 2221 | ------------------------------------------------------------- |
| 2185 | 2222 | |
| 2186 | − In a topology such as the example above, the active-backup and | |
| 2223 | +In a topology such as the example above, the active-backup and | |
| 2187 | 2224 | broadcast modes are the only useful bonding modes when optimizing for |
| 2188 | 2225 | availability; the other modes require all links to terminate on the |
| 2189 | 2226 | same peer for them to behave rationally. |
| 2190 | 2227 | |
| 2191 | −active-backup: This is generally the preferred mode, particularly if | |
| 2228 | +active-backup: | |
| 2229 | + This is generally the preferred mode, particularly if | |
| 2192 | 2230 | the switches have an ISL and play together well. If the |
| 2193 | 2231 | network configuration is such that one switch is specifically |
| 2194 | 2232 | a backup switch (e.g., has lower capacity, higher cost, etc), |
| 2195 | 2233 | then the primary option can be used to insure that the |
| 2196 | 2234 | preferred link is always used when it is available. |
| 2197 | 2235 | |
| 2198 | −broadcast: This mode is really a special purpose mode, and is suitable | |
| 2236 | +broadcast: | |
| 2237 | + This mode is really a special purpose mode, and is suitable | |
| 2199 | 2238 | only for very specific needs. For example, if the two |
| 2200 | 2239 | switches are not connected (no ISL), and the networks beyond |
| 2201 | 2240 | them are totally independent. In this case, if it is |
| @@ -2205,7 +2244,7 @@ broadcast: This mode is really a special purpose mode, and is suitable · 3 unmodified lines | ||
| 2205 | 2244 | 11.2.2 HA Link Monitoring Selection for Multiple Switch Topology |
| 2206 | 2245 | ---------------------------------------------------------------- |
| 2207 | 2246 | |
| 2208 | − The choice of link monitoring ultimately depends upon your | |
| 2247 | +The choice of link monitoring ultimately depends upon your | |
| 2209 | 2248 | switch. If the switch can reliably fail ports in response to other |
| 2210 | 2249 | failures, then either the MII or ARP monitors should work. For |
| 2211 | 2250 | example, in the above example, if the "port3" link fails at the remote |
| @@ -2213,7 +2252,7 @@ end, the MII monitor has no direct means to detect this. The ARP · 1 unmodified line | ||
| 2213 | 2252 | monitor could be configured with a target at the remote end of port3, |
| 2214 | 2253 | thus detecting that failure without switch support. |
| 2215 | 2254 | |
| 2216 | − In general, however, in a multiple switch topology, the ARP | |
| 2255 | +In general, however, in a multiple switch topology, the ARP | |
| 2217 | 2256 | monitor can provide a higher level of reliability in detecting end to |
| 2218 | 2257 | end connectivity failures (which may be caused by the failure of any |
| 2219 | 2258 | individual component to pass traffic for any reason). Additionally, |
| @@ -2222,7 +2261,7 @@ one for each switch in the network). This will insure that, · 2 unmodified lines | ||
| 2222 | 2261 | regardless of which switch is active, the ARP monitor has a suitable |
| 2223 | 2262 | target to query. |
| 2224 | 2263 | |
| 2225 | − Note, also, that of late many switches now support a functionality | |
| 2264 | +Note, also, that of late many switches now support a functionality | |
| 2226 | 2265 | generally referred to as "trunk failover." This is a feature of the |
| 2227 | 2266 | switch that causes the link state of a particular switch port to be set |
| 2228 | 2267 | down (or up) when the state of another switch port goes down (or up). |
| @@ -2238,18 +2277,18 @@ suitable switches. · 9 unmodified lines | ||
| 2238 | 2277 | 12.1 Maximizing Throughput in a Single Switch Topology |
| 2239 | 2278 | ------------------------------------------------------ |
| 2240 | 2279 | |
| 2241 | − In a single switch configuration, the best method to maximize | |
| 2280 | +In a single switch configuration, the best method to maximize | |
| 2242 | 2281 | throughput depends upon the application and network environment. The |
| 2243 | 2282 | various load balancing modes each have strengths and weaknesses in |
| 2244 | 2283 | different environments, as detailed below. |
| 2245 | 2284 | |
| 2246 | − For this discussion, we will break down the topologies into | |
| 2285 | +For this discussion, we will break down the topologies into | |
| 2247 | 2286 | two categories. Depending upon the destination of most traffic, we |
| 2248 | 2287 | categorize them into either "gatewayed" or "local" configurations. |
| 2249 | 2288 | |
| 2250 | − In a gatewayed configuration, the "switch" is acting primarily | |
| 2289 | +In a gatewayed configuration, the "switch" is acting primarily | |
| 2251 | 2290 | as a router, and the majority of traffic passes through this router to |
| 2252 | −other networks. An example would be the following: | |
| 2291 | +other networks. An example would be the following:: | |
| 2253 | 2292 | |
| 2254 | 2293 | |
| 2255 | 2294 | +----------+ +----------+ |
| @@ -2259,25 +2298,25 @@ other networks. An example would be the following: · 3 unmodified lines | ||
| 2259 | 2298 | | |eth1 port2| | here somewhere |
| 2260 | 2299 | +----------+ +----------+ |
| 2261 | 2300 | |
| 2262 | − The router may be a dedicated router device, or another host | |
| 2301 | +The router may be a dedicated router device, or another host | |
| 2263 | 2302 | acting as a gateway. For our discussion, the important point is that |
| 2264 | 2303 | the majority of traffic from Host A will pass through the router to |
| 2265 | 2304 | some other network before reaching its final destination. |
| 2266 | 2305 | |
| 2267 | − In a gatewayed network configuration, although Host A may | |
| 2306 | +In a gatewayed network configuration, although Host A may | |
| 2268 | 2307 | communicate with many other systems, all of its traffic will be sent |
| 2269 | 2308 | and received via one other peer on the local network, the router. |
| 2270 | 2309 | |
| 2271 | − Note that the case of two systems connected directly via | |
| 2310 | +Note that the case of two systems connected directly via | |
| 2272 | 2311 | multiple physical links is, for purposes of configuring bonding, the |
| 2273 | 2312 | same as a gatewayed configuration. In that case, it happens that all |
| 2274 | 2313 | traffic is destined for the "gateway" itself, not some other network |
| 2275 | 2314 | beyond the gateway. |
| 2276 | 2315 | |
| 2277 | − In a local configuration, the "switch" is acting primarily as | |
| 2316 | +In a local configuration, the "switch" is acting primarily as | |
| 2278 | 2317 | a switch, and the majority of traffic passes through this switch to |
| 2279 | 2318 | reach other stations on the same network. An example would be the |
| 2280 | −following: | |
| 2319 | +following:: | |
| 2281 | 2320 | |
| 2282 | 2321 | +----------+ +----------+ +--------+ |
| 2283 | 2322 | | |eth0 port1| +-------+ Host B | |
| @@ -2287,19 +2326,19 @@ following: · 3 unmodified lines | ||
| 2287 | 2326 | +----------+ +----------+port4 +--------+ |
| 2288 | 2327 | |
| 2289 | 2328 | |
| 2290 | − Again, the switch may be a dedicated switch device, or another | |
| 2329 | +Again, the switch may be a dedicated switch device, or another | |
| 2291 | 2330 | host acting as a gateway. For our discussion, the important point is |
| 2292 | 2331 | that the majority of traffic from Host A is destined for other hosts |
| 2293 | 2332 | on the same local network (Hosts B and C in the above example). |
| 2294 | 2333 | |
| 2295 | − In summary, in a gatewayed configuration, traffic to and from | |
| 2334 | +In summary, in a gatewayed configuration, traffic to and from | |
| 2296 | 2335 | the bonded device will be to the same MAC level peer on the network |
| 2297 | 2336 | (the gateway itself, i.e., the router), regardless of its final |
| 2298 | 2337 | destination. In a local configuration, traffic flows directly to and |
| 2299 | 2338 | from the final destinations, thus, each destination (Host B, Host C) |
| 2300 | 2339 | will be addressed directly by their individual MAC addresses. |
| 2301 | 2340 | |
| 2302 | − This distinction between a gatewayed and a local network | |
| 2341 | +This distinction between a gatewayed and a local network | |
| 2303 | 2342 | configuration is important because many of the load balancing modes |
| 2304 | 2343 | available use the MAC addresses of the local network source and |
| 2305 | 2344 | destination to make load balancing decisions. The behavior of each |
| @@ -2309,11 +2348,12 @@ mode is described below. · 3 unmodified lines | ||
| 2309 | 2348 | 12.1.1 MT Bonding Mode Selection for Single Switch Topology |
| 2310 | 2349 | ----------------------------------------------------------- |
| 2311 | 2350 | |
| 2312 | − This configuration is the easiest to set up and to understand, | |
| 2351 | +This configuration is the easiest to set up and to understand, | |
| 2313 | 2352 | although you will have to decide which bonding mode best suits your |
| 2314 | 2353 | needs. The trade offs for each mode are detailed below: |
| 2315 | 2354 | |
| 2316 | −balance-rr: This mode is the only mode that will permit a single | |
| 2355 | +balance-rr: | |
| 2356 | + This mode is the only mode that will permit a single | |
| 2317 | 2357 | TCP/IP connection to stripe traffic across multiple |
| 2318 | 2358 | interfaces. It is therefore the only mode that will allow a |
| 2319 | 2359 | single TCP/IP stream to utilize more than one interface's |
| @@ -2351,7 +2391,8 @@ balance-rr: This mode is the only mode that will permit a single · 31 unmodified lines | ||
| 2351 | 2391 | This mode requires the switch to have the appropriate ports |
| 2352 | 2392 | configured for "etherchannel" or "trunking." |
| 2353 | 2393 | |
| 2354 | −active-backup: There is not much advantage in this network topology to | |
| 2394 | +active-backup: | |
| 2395 | + There is not much advantage in this network topology to | |
| 2355 | 2396 | the active-backup mode, as the inactive backup devices are all |
| 2356 | 2397 | connected to the same peer as the primary. In this case, a |
| 2357 | 2398 | load balancing mode (with link monitoring) will provide the |
| @@ -2361,7 +2402,8 @@ active-backup: There is not much advantage in this network topology to · 3 unmodified lines | ||
| 2361 | 2402 | have value if the hardware available does not support any of |
| 2362 | 2403 | the load balance modes. |
| 2363 | 2404 | |
| 2364 | −balance-xor: This mode will limit traffic such that packets destined | |
| 2405 | +balance-xor: | |
| 2406 | + This mode will limit traffic such that packets destined | |
| 2365 | 2407 | for specific peers will always be sent over the same |
| 2366 | 2408 | interface. Since the destination is determined by the MAC |
| 2367 | 2409 | addresses involved, this mode works best in a "local" network |
| @@ -2373,10 +2415,12 @@ balance-xor: This mode will limit traffic such that packets destined · 5 unmodified lines | ||
| 2373 | 2415 | As with balance-rr, the switch ports need to be configured for |
| 2374 | 2416 | "etherchannel" or "trunking." |
| 2375 | 2417 | |
| 2376 | −broadcast: Like active-backup, there is not much advantage to this | |
| 2418 | +broadcast: | |
| 2419 | + Like active-backup, there is not much advantage to this | |
| 2377 | 2420 | mode in this type of network topology. |
| 2378 | 2421 | |
| 2379 | −802.3ad: This mode can be a good choice for this type of network | |
| 2422 | +802.3ad: | |
| 2423 | + This mode can be a good choice for this type of network | |
| 2380 | 2424 | topology. The 802.3ad mode is an IEEE standard, so all peers |
| 2381 | 2425 | that implement 802.3ad should interoperate well. The 802.3ad |
| 2382 | 2426 | protocol includes automatic configuration of the aggregates, |
| @@ -2390,7 +2434,7 @@ broadcast: Like active-backup, there is not much advantage to this · 7 unmodified lines | ||
| 2390 | 2434 | the same speed and duplex. Also, as with all bonding load |
| 2391 | 2435 | balance modes other than balance-rr, no single connection will |
| 2392 | 2436 | be able to utilize more than a single interface's worth of |
| 2393 | − bandwidth. | |
| 2437 | + bandwidth. | |
| 2394 | 2438 | |
| 2395 | 2439 | Additionally, the linux bonding 802.3ad implementation |
| 2396 | 2440 | distributes traffic by peer (using an XOR of MAC addresses |
| @@ -2404,7 +2448,8 @@ broadcast: Like active-backup, there is not much advantage to this · 7 unmodified lines | ||
| 2404 | 2448 | Finally, the 802.3ad mode mandates the use of the MII monitor, |
| 2405 | 2449 | therefore, the ARP monitor is not available in this mode. |
| 2406 | 2450 | |
| 2407 | −balance-tlb: The balance-tlb mode balances outgoing traffic by peer. | |
| 2451 | +balance-tlb: | |
| 2452 | + The balance-tlb mode balances outgoing traffic by peer. | |
| 2408 | 2453 | Since the balancing is done according to MAC address, in a |
| 2409 | 2454 | "gatewayed" configuration (as described above), this mode will |
| 2410 | 2455 | send all traffic across a single device. However, in a |
| @@ -2422,7 +2467,8 @@ balance-tlb: The balance-tlb mode balances outgoing traffic by peer. · 11 unmodified lines | ||
| 2422 | 2467 | network device driver of the slave interfaces, and the ARP |
| 2423 | 2468 | monitor is not available. |
| 2424 | 2469 | |
| 2425 | −balance-alb: This mode is everything that balance-tlb is, and more. | |
| 2470 | +balance-alb: | |
| 2471 | + This mode is everything that balance-tlb is, and more. | |
| 2426 | 2472 | It has all of the features (and restrictions) of balance-tlb, |
| 2427 | 2473 | and will also balance incoming traffic from local network |
| 2428 | 2474 | peers (as described in the Bonding Module Options section, |
| @@ -2435,7 +2481,7 @@ balance-alb: This mode is everything that balance-tlb is, and more. · 6 unmodified lines | ||
| 2435 | 2481 | 12.1.2 MT Link Monitoring for Single Switch Topology |
| 2436 | 2482 | ---------------------------------------------------- |
| 2437 | 2483 | |
| 2438 | − The choice of link monitoring may largely depend upon which | |
| 2484 | +The choice of link monitoring may largely depend upon which | |
| 2439 | 2485 | mode you choose to use. The more advanced load balancing modes do not |
| 2440 | 2486 | support the use of the ARP monitor, and are thus restricted to using |
| 2441 | 2487 | the MII monitor (which does not provide as high a level of end to end |
| @@ -2444,27 +2490,27 @@ assurance as the ARP monitor). · 2 unmodified lines | ||
| 2444 | 2490 | 12.2 Maximum Throughput in a Multiple Switch Topology |
| 2445 | 2491 | ----------------------------------------------------- |
| 2446 | 2492 | |
| 2447 | − Multiple switches may be utilized to optimize for throughput | |
| 2493 | +Multiple switches may be utilized to optimize for throughput | |
| 2448 | 2494 | when they are configured in parallel as part of an isolated network |
| 2449 | −between two or more systems, for example: | |
| 2450 | − | |
| 2451 | − +-----------+ | |
| 2452 | − | Host A | | |
| 2453 | − +-+---+---+-+ | |
| 2454 | − | | | | |
| 2455 | − +--------+ | +---------+ | |
| 2456 | − | | | | |
| 2457 | − +------+---+ +-----+----+ +-----+----+ | |
| 2458 | − | Switch A | | Switch B | | Switch C | | |
| 2459 | − +------+---+ +-----+----+ +-----+----+ | |
| 2460 | − | | | | |
| 2461 | − +--------+ | +---------+ | |
| 2462 | − | | | | |
| 2463 | − +-+---+---+-+ | |
| 2464 | − | Host B | | |
| 2465 | − +-----------+ | |
| 2466 | − | |
| 2467 | − In this configuration, the switches are isolated from one | |
| 2495 | +between two or more systems, for example:: | |
| 2496 | + | |
| 2497 | + +-----------+ | |
| 2498 | + | Host A | | |
| 2499 | + +-+---+---+-+ | |
| 2500 | + | | | | |
| 2501 | + +--------+ | +---------+ | |
| 2502 | + | | | | |
| 2503 | + +------+---+ +-----+----+ +-----+----+ | |
| 2504 | + | Switch A | | Switch B | | Switch C | | |
| 2505 | + +------+---+ +-----+----+ +-----+----+ | |
| 2506 | + | | | | |
| 2507 | + +--------+ | +---------+ | |
| 2508 | + | | | | |
| 2509 | + +-+---+---+-+ | |
| 2510 | + | Host B | | |
| 2511 | + +-----------+ | |
| 2512 | + | |
| 2513 | +In this configuration, the switches are isolated from one | |
| 2468 | 2514 | another. One reason to employ a topology such as this is for an |
| 2469 | 2515 | isolated network with many hosts (a cluster configured for high |
| 2470 | 2516 | performance, for example), using multiple smaller switches can be more |
| @@ -2472,14 +2518,14 @@ cost effective than a single larger switch, e.g., on a network with 24 · 1 unmodified line | ||
| 2472 | 2518 | hosts, three 24 port switches can be significantly less expensive than |
| 2473 | 2519 | a single 72 port switch. |
| 2474 | 2520 | |
| 2475 | − If access beyond the network is required, an individual host | |
| 2521 | +If access beyond the network is required, an individual host | |
| 2476 | 2522 | can be equipped with an additional network device connected to an |
| 2477 | 2523 | external network; this host then additionally acts as a gateway. |
| 2478 | 2524 | |
| 2479 | 2525 | 12.2.1 MT Bonding Mode Selection for Multiple Switch Topology |
| 2480 | 2526 | ------------------------------------------------------------- |
| 2481 | 2527 | |
| 2482 | − In actual practice, the bonding mode typically employed in | |
| 2528 | +In actual practice, the bonding mode typically employed in | |
| 2483 | 2529 | configurations of this type is balance-rr. Historically, in this |
| 2484 | 2530 | network configuration, the usual caveats about out of order packet |
| 2485 | 2531 | delivery are mitigated by the use of network adapters that do not do |
| @@ -2492,7 +2538,7 @@ utilize greater than one interface's bandwidth. · 6 unmodified lines | ||
| 2492 | 2538 | 12.2.2 MT Link Monitoring for Multiple Switch Topology |
| 2493 | 2539 | ------------------------------------------------------ |
| 2494 | 2540 | |
| 2495 | − Again, in actual practice, the MII monitor is most often used | |
| 2541 | +Again, in actual practice, the MII monitor is most often used | |
| 2496 | 2542 | in this configuration, as performance is given preference over |
| 2497 | 2543 | availability. The ARP monitor will function in this topology, but its |
| 2498 | 2544 | advantages over the MII monitor are mitigated by the volume of probes |
| @@ -2505,10 +2551,10 @@ host in the network is configured with bonding). · 6 unmodified lines | ||
| 2505 | 2551 | 13.1 Link Establishment and Failover Delays |
| 2506 | 2552 | ------------------------------------------- |
| 2507 | 2553 | |
| 2508 | − Some switches exhibit undesirable behavior with regard to the | |
| 2554 | +Some switches exhibit undesirable behavior with regard to the | |
| 2509 | 2555 | timing of link up and down reporting by the switch. |
| 2510 | 2556 | |
| 2511 | − First, when a link comes up, some switches may indicate that | |
| 2557 | +First, when a link comes up, some switches may indicate that | |
| 2512 | 2558 | the link is up (carrier available), but not pass traffic over the |
| 2513 | 2559 | interface for some period of time. This delay is typically due to |
| 2514 | 2560 | some type of autonegotiation or routing protocol, but may also occur |
| @@ -2517,12 +2563,12 @@ failure). If you find this to be a problem, specify an appropriate · 2 unmodified lines | ||
| 2517 | 2563 | value to the updelay bonding module option to delay the use of the |
| 2518 | 2564 | relevant interface(s). |
| 2519 | 2565 | |
| 2520 | − Second, some switches may "bounce" the link state one or more | |
| 2566 | +Second, some switches may "bounce" the link state one or more | |
| 2521 | 2567 | times while a link is changing state. This occurs most commonly while |
| 2522 | 2568 | the switch is initializing. Again, an appropriate updelay value may |
| 2523 | 2569 | help. |
| 2524 | 2570 | |
| 2525 | − Note that when a bonding interface has no active links, the | |
| 2571 | +Note that when a bonding interface has no active links, the | |
| 2526 | 2572 | driver will immediately reuse the first link that goes up, even if the |
| 2527 | 2573 | updelay parameter has been specified (the updelay is ignored in this |
| 2528 | 2574 | case). If there are slave interfaces waiting for the updelay timeout |
| @@ -2532,7 +2578,7 @@ value of updelay has been overestimated, and since this occurs only in · 3 unmodified lines | ||
| 2532 | 2578 | cases with no connectivity, there is no additional penalty for |
| 2533 | 2579 | ignoring the updelay. |
| 2534 | 2580 | |
| 2535 | − In addition to the concerns about switch timings, if your | |
| 2581 | +In addition to the concerns about switch timings, if your | |
| 2536 | 2582 | switches take a long time to go into backup mode, it may be desirable |
| 2537 | 2583 | to not activate a backup interface immediately after a link goes down. |
| 2538 | 2584 | Failover may be delayed via the downdelay bonding module option. |
| @@ -2540,31 +2586,31 @@ Failover may be delayed via the downdelay bonding module option. · 1 unmodified line | ||
| 2540 | 2586 | 13.2 Duplicated Incoming Packets |
| 2541 | 2587 | -------------------------------- |
| 2542 | 2588 | |
| 2543 | − NOTE: Starting with version 3.0.2, the bonding driver has logic to | |
| 2589 | +NOTE: Starting with version 3.0.2, the bonding driver has logic to | |
| 2544 | 2590 | suppress duplicate packets, which should largely eliminate this problem. |
| 2545 | 2591 | The following description is kept for reference. |
| 2546 | 2592 | |
| 2547 | − It is not uncommon to observe a short burst of duplicated | |
| 2593 | +It is not uncommon to observe a short burst of duplicated | |
| 2548 | 2594 | traffic when the bonding device is first used, or after it has been |
| 2549 | 2595 | idle for some period of time. This is most easily observed by issuing |
| 2550 | 2596 | a "ping" to some other host on the network, and noticing that the |
| 2551 | 2597 | output from ping flags duplicates (typically one per slave). |
| 2552 | 2598 | |
| 2553 | − For example, on a bond in active-backup mode with five slaves | |
| 2554 | −all connected to one switch, the output may appear as follows: | |
| 2555 | − | |
| 2556 | −# ping -n 10.0.4.2 | |
| 2557 | −PING 10.0.4.2 (10.0.4.2) from 10.0.3.10 : 56(84) bytes of data. | |
| 2558 | −64 bytes from 10.0.4.2: icmp_seq=1 ttl=64 time=13.7 ms | |
| 2559 | −64 bytes from 10.0.4.2: icmp_seq=1 ttl=64 time=13.8 ms (DUP!) | |
| 2560 | −64 bytes from 10.0.4.2: icmp_seq=1 ttl=64 time=13.8 ms (DUP!) | |
| 2561 | −64 bytes from 10.0.4.2: icmp_seq=1 ttl=64 time=13.8 ms (DUP!) | |
| 2562 | −64 bytes from 10.0.4.2: icmp_seq=1 ttl=64 time=13.8 ms (DUP!) | |
| 2563 | −64 bytes from 10.0.4.2: icmp_seq=2 ttl=64 time=0.216 ms | |
| 2564 | −64 bytes from 10.0.4.2: icmp_seq=3 ttl=64 time=0.267 ms | |
| 2565 | −64 bytes from 10.0.4.2: icmp_seq=4 ttl=64 time=0.222 ms | |
| 2566 | − | |
| 2567 | − This is not due to an error in the bonding driver, rather, it | |
| 2599 | +For example, on a bond in active-backup mode with five slaves | |
| 2600 | +all connected to one switch, the output may appear as follows:: | |
| 2601 | + | |
| 2602 | + # ping -n 10.0.4.2 | |
| 2603 | + PING 10.0.4.2 (10.0.4.2) from 10.0.3.10 : 56(84) bytes of data. | |
| 2604 | + 64 bytes from 10.0.4.2: icmp_seq=1 ttl=64 time=13.7 ms | |
| 2605 | + 64 bytes from 10.0.4.2: icmp_seq=1 ttl=64 time=13.8 ms (DUP!) | |
| 2606 | + 64 bytes from 10.0.4.2: icmp_seq=1 ttl=64 time=13.8 ms (DUP!) | |
| 2607 | + 64 bytes from 10.0.4.2: icmp_seq=1 ttl=64 time=13.8 ms (DUP!) | |
| 2608 | + 64 bytes from 10.0.4.2: icmp_seq=1 ttl=64 time=13.8 ms (DUP!) | |
| 2609 | + 64 bytes from 10.0.4.2: icmp_seq=2 ttl=64 time=0.216 ms | |
| 2610 | + 64 bytes from 10.0.4.2: icmp_seq=3 ttl=64 time=0.267 ms | |
| 2611 | + 64 bytes from 10.0.4.2: icmp_seq=4 ttl=64 time=0.222 ms | |
| 2612 | + | |
| 2613 | +This is not due to an error in the bonding driver, rather, it | |
| 2568 | 2614 | is a side effect of how many switches update their MAC forwarding |
| 2569 | 2615 | tables. Initially, the switch does not associate the MAC address in |
| 2570 | 2616 | the packet with a particular switch port, and so it may send the |
| @@ -2574,7 +2620,7 @@ single switch, when the switch (temporarily) floods the traffic to all · 3 unmodified lines | ||
| 2574 | 2620 | ports, the bond device receives multiple copies of the same packet |
| 2575 | 2621 | (one per slave device). |
| 2576 | 2622 | |
| 2577 | − The duplicated packet behavior is switch dependent, some | |
| 2623 | +The duplicated packet behavior is switch dependent, some | |
| 2578 | 2624 | switches exhibit this, and some do not. On switches that display this |
| 2579 | 2625 | behavior, it can be induced by clearing the MAC forwarding table (on |
| 2580 | 2626 | most Cisco switches, the privileged command "clear mac address-table |
| @@ -2583,16 +2629,16 @@ dynamic" will accomplish this). · 2 unmodified lines | ||
| 2583 | 2629 | 14. Hardware Specific Considerations |
| 2584 | 2630 | ==================================== |
| 2585 | 2631 | |
| 2586 | − This section contains additional information for configuring | |
| 2632 | +This section contains additional information for configuring | |
| 2587 | 2633 | bonding on specific hardware platforms, or for interfacing bonding |
| 2588 | 2634 | with particular switches or other devices. |
| 2589 | 2635 | |
| 2590 | 2636 | 14.1 IBM BladeCenter |
| 2591 | 2637 | -------------------- |
| 2592 | 2638 | |
| 2593 | − This applies to the JS20 and similar systems. | |
| 2639 | +This applies to the JS20 and similar systems. | |
| 2594 | 2640 | |
| 2595 | − On the JS20 blades, the bonding driver supports only | |
| 2641 | +On the JS20 blades, the bonding driver supports only | |
| 2596 | 2642 | balance-rr, active-backup, balance-tlb and balance-alb modes. This is |
| 2597 | 2643 | largely due to the network topology inside the BladeCenter, detailed |
| 2598 | 2644 | below. |
| @@ -2600,7 +2646,7 @@ below. · 1 unmodified line | ||
| 2600 | 2646 | JS20 network adapter information |
| 2601 | 2647 | -------------------------------- |
| 2602 | 2648 | |
| 2603 | − All JS20s come with two Broadcom Gigabit Ethernet ports | |
| 2649 | +All JS20s come with two Broadcom Gigabit Ethernet ports | |
| 2604 | 2650 | integrated on the planar (that's "motherboard" in IBM-speak). In the |
| 2605 | 2651 | BladeCenter chassis, the eth0 port of all JS20 blades is hard wired to |
| 2606 | 2652 | I/O Module #1; similarly, all eth1 ports are wired to I/O Module #2. |
| @@ -2608,36 +2654,36 @@ An add-on Broadcom daughter card can be installed on a JS20 to provide · 1 unmodified line | ||
| 2608 | 2654 | two more Gigabit Ethernet ports. These ports, eth2 and eth3, are |
| 2609 | 2655 | wired to I/O Modules 3 and 4, respectively. |
| 2610 | 2656 | |
| 2611 | − Each I/O Module may contain either a switch or a passthrough | |
| 2657 | +Each I/O Module may contain either a switch or a passthrough | |
| 2612 | 2658 | module (which allows ports to be directly connected to an external |
| 2613 | 2659 | switch). Some bonding modes require a specific BladeCenter internal |
| 2614 | 2660 | network topology in order to function; these are detailed below. |
| 2615 | 2661 | |
| 2616 | − Additional BladeCenter-specific networking information can be | |
| 2662 | +Additional BladeCenter-specific networking information can be | |
| 2617 | 2663 | found in two IBM Redbooks (www.ibm.com/redbooks): |
| 2618 | 2664 | |
| 2619 | −"IBM eServer BladeCenter Networking Options" | |
| 2620 | −"IBM eServer BladeCenter Layer 2-7 Network Switching" | |
| 2665 | +- "IBM eServer BladeCenter Networking Options" | |
| 2666 | +- "IBM eServer BladeCenter Layer 2-7 Network Switching" | |
| 2621 | 2667 | |
| 2622 | 2668 | BladeCenter networking configuration |
| 2623 | 2669 | ------------------------------------ |
| 2624 | 2670 | |
| 2625 | − Because a BladeCenter can be configured in a very large number | |
| 2671 | +Because a BladeCenter can be configured in a very large number | |
| 2626 | 2672 | of ways, this discussion will be confined to describing basic |
| 2627 | 2673 | configurations. |
| 2628 | 2674 | |
| 2629 | − Normally, Ethernet Switch Modules (ESMs) are used in I/O | |
| 2675 | +Normally, Ethernet Switch Modules (ESMs) are used in I/O | |
| 2630 | 2676 | modules 1 and 2. In this configuration, the eth0 and eth1 ports of a |
| 2631 | 2677 | JS20 will be connected to different internal switches (in the |
| 2632 | 2678 | respective I/O modules). |
| 2633 | 2679 | |
| 2634 | − A passthrough module (OPM or CPM, optical or copper, | |
| 2680 | +A passthrough module (OPM or CPM, optical or copper, | |
| 2635 | 2681 | passthrough module) connects the I/O module directly to an external |
| 2636 | 2682 | switch. By using PMs in I/O module #1 and #2, the eth0 and eth1 |
| 2637 | 2683 | interfaces of a JS20 can be redirected to the outside world and |
| 2638 | 2684 | connected to a common external switch. |
| 2639 | 2685 | |
| 2640 | − Depending upon the mix of ESMs and PMs, the network will | |
| 2686 | +Depending upon the mix of ESMs and PMs, the network will | |
| 2641 | 2687 | appear to bonding as either a single switch topology (all PMs) or as a |
| 2642 | 2688 | multiple switch topology (one or more ESMs, zero or more PMs). It is |
| 2643 | 2689 | also possible to connect ESMs together, resulting in a configuration |
| @@ -2647,24 +2693,24 @@ Topology," above. · 3 unmodified lines | ||
| 2647 | 2693 | Requirements for specific modes |
| 2648 | 2694 | ------------------------------- |
| 2649 | 2695 | |
| 2650 | − The balance-rr mode requires the use of passthrough modules | |
| 2696 | +The balance-rr mode requires the use of passthrough modules | |
| 2651 | 2697 | for devices in the bond, all connected to an common external switch. |
| 2652 | 2698 | That switch must be configured for "etherchannel" or "trunking" on the |
| 2653 | 2699 | appropriate ports, as is usual for balance-rr. |
| 2654 | 2700 | |
| 2655 | − The balance-alb and balance-tlb modes will function with | |
| 2701 | +The balance-alb and balance-tlb modes will function with | |
| 2656 | 2702 | either switch modules or passthrough modules (or a mix). The only |
| 2657 | 2703 | specific requirement for these modes is that all network interfaces |
| 2658 | 2704 | must be able to reach all destinations for traffic sent over the |
| 2659 | 2705 | bonding device (i.e., the network must converge at some point outside |
| 2660 | 2706 | the BladeCenter). |
| 2661 | 2707 | |
| 2662 | − The active-backup mode has no additional requirements. | |
| 2708 | +The active-backup mode has no additional requirements. | |
| 2663 | 2709 | |
| 2664 | 2710 | Link monitoring issues |
| 2665 | 2711 | ---------------------- |
| 2666 | 2712 | |
| 2667 | − When an Ethernet Switch Module is in place, only the ARP | |
| 2713 | +When an Ethernet Switch Module is in place, only the ARP | |
| 2668 | 2714 | monitor will reliably detect link loss to an external switch. This is |
| 2669 | 2715 | nothing unusual, but examination of the BladeCenter cabinet would |
| 2670 | 2716 | suggest that the "external" network ports are the ethernet ports for |
| @@ -2672,166 +2718,173 @@ the system, when it fact there is a switch between these "external" · 1 unmodified line | ||
| 2672 | 2718 | ports and the devices on the JS20 system itself. The MII monitor is |
| 2673 | 2719 | only able to detect link failures between the ESM and the JS20 system. |
| 2674 | 2720 | |
| 2675 | − When a passthrough module is in place, the MII monitor does | |
| 2721 | +When a passthrough module is in place, the MII monitor does | |
| 2676 | 2722 | detect failures to the "external" port, which is then directly |
| 2677 | 2723 | connected to the JS20 system. |
| 2678 | 2724 | |
| 2679 | 2725 | Other concerns |
| 2680 | 2726 | -------------- |
| 2681 | 2727 | |
| 2682 | − The Serial Over LAN (SoL) link is established over the primary | |
| 2728 | +The Serial Over LAN (SoL) link is established over the primary | |
| 2683 | 2729 | ethernet (eth0) only, therefore, any loss of link to eth0 will result |
| 2684 | 2730 | in losing your SoL connection. It will not fail over with other |
| 2685 | 2731 | network traffic, as the SoL system is beyond the control of the |
| 2686 | 2732 | bonding driver. |
| 2687 | 2733 | |
| 2688 | − It may be desirable to disable spanning tree on the switch | |
| 2734 | +It may be desirable to disable spanning tree on the switch | |
| 2689 | 2735 | (either the internal Ethernet Switch Module, or an external switch) to |
| 2690 | 2736 | avoid fail-over delay issues when using bonding. |
| 2691 | 2737 | |
| 2692 | − | |
| 2738 | + | |
| 2693 | 2739 | 15. Frequently Asked Questions |
| 2694 | 2740 | ============================== |
| 2695 | 2741 | |
| 2696 | 2742 | 1. Is it SMP safe? |
| 2743 | +------------------- | |
| 2697 | 2744 | |
| 2698 | − Yes. The old 2.0.xx channel bonding patch was not SMP safe. | |
| 2745 | +Yes. The old 2.0.xx channel bonding patch was not SMP safe. | |
| 2699 | 2746 | The new driver was designed to be SMP safe from the start. |
| 2700 | 2747 | |
| 2701 | 2748 | 2. What type of cards will work with it? |
| 2749 | +----------------------------------------- | |
| 2702 | 2750 | |
| 2703 | − Any Ethernet type cards (you can even mix cards - a Intel | |
| 2751 | +Any Ethernet type cards (you can even mix cards - a Intel | |
| 2704 | 2752 | EtherExpress PRO/100 and a 3com 3c905b, for example). For most modes, |
| 2705 | 2753 | devices need not be of the same speed. |
| 2706 | 2754 | |
| 2707 | − Starting with version 3.2.1, bonding also supports Infiniband | |
| 2755 | +Starting with version 3.2.1, bonding also supports Infiniband | |
| 2708 | 2756 | slaves in active-backup mode. |
| 2709 | 2757 | |
| 2710 | 2758 | 3. How many bonding devices can I have? |
| 2759 | +---------------------------------------- | |
| 2711 | 2760 | |
| 2712 | − There is no limit. | |
| 2761 | +There is no limit. | |
| 2713 | 2762 | |
| 2714 | 2763 | 4. How many slaves can a bonding device have? |
| 2764 | +---------------------------------------------- | |
| 2715 | 2765 | |
| 2716 | − This is limited only by the number of network interfaces Linux | |
| 2766 | +This is limited only by the number of network interfaces Linux | |
| 2717 | 2767 | supports and/or the number of network cards you can place in your |
| 2718 | 2768 | system. |
| 2719 | 2769 | |
| 2720 | 2770 | 5. What happens when a slave link dies? |
| 2771 | +---------------------------------------- | |
| 2721 | 2772 | |
| 2722 | − If link monitoring is enabled, then the failing device will be | |
| 2773 | +If link monitoring is enabled, then the failing device will be | |
| 2723 | 2774 | disabled. The active-backup mode will fail over to a backup link, and |
| 2724 | 2775 | other modes will ignore the failed link. The link will continue to be |
| 2725 | 2776 | monitored, and should it recover, it will rejoin the bond (in whatever |
| 2726 | 2777 | manner is appropriate for the mode). See the sections on High |
| 2727 | 2778 | Availability and the documentation for each mode for additional |
| 2728 | 2779 | information. |
| 2729 | − | |
| 2730 | − Link monitoring can be enabled via either the miimon or | |
| 2780 | + | |
| 2781 | +Link monitoring can be enabled via either the miimon or | |
| 2731 | 2782 | arp_interval parameters (described in the module parameters section, |
| 2732 | 2783 | above). In general, miimon monitors the carrier state as sensed by |
| 2733 | 2784 | the underlying network device, and the arp monitor (arp_interval) |
| 2734 | 2785 | monitors connectivity to another host on the local network. |
| 2735 | 2786 | |
| 2736 | − If no link monitoring is configured, the bonding driver will | |
| 2787 | +If no link monitoring is configured, the bonding driver will | |
| 2737 | 2788 | be unable to detect link failures, and will assume that all links are |
| 2738 | 2789 | always available. This will likely result in lost packets, and a |
| 2739 | 2790 | resulting degradation of performance. The precise performance loss |
| 2740 | 2791 | depends upon the bonding mode and network configuration. |
| 2741 | 2792 | |
| 2742 | 2793 | 6. Can bonding be used for High Availability? |
| 2794 | +---------------------------------------------- | |
| 2743 | 2795 | |
| 2744 | − Yes. See the section on High Availability for details. | |
| 2796 | +Yes. See the section on High Availability for details. | |
| 2745 | 2797 | |
| 2746 | 2798 | 7. Which switches/systems does it work with? |
| 2799 | +--------------------------------------------- | |
| 2747 | 2800 | |
| 2748 | − The full answer to this depends upon the desired mode. | |
| 2801 | +The full answer to this depends upon the desired mode. | |
| 2749 | 2802 | |
| 2750 | − In the basic balance modes (balance-rr and balance-xor), it | |
| 2803 | +In the basic balance modes (balance-rr and balance-xor), it | |
| 2751 | 2804 | works with any system that supports etherchannel (also called |
| 2752 | 2805 | trunking). Most managed switches currently available have such |
| 2753 | 2806 | support, and many unmanaged switches as well. |
| 2754 | 2807 | |
| 2755 | − The advanced balance modes (balance-tlb and balance-alb) do | |
| 2808 | +The advanced balance modes (balance-tlb and balance-alb) do | |
| 2756 | 2809 | not have special switch requirements, but do need device drivers that |
| 2757 | 2810 | support specific features (described in the appropriate section under |
| 2758 | 2811 | module parameters, above). |
| 2759 | 2812 | |
| 2760 | − In 802.3ad mode, it works with systems that support IEEE | |
| 2813 | +In 802.3ad mode, it works with systems that support IEEE | |
| 2761 | 2814 | 802.3ad Dynamic Link Aggregation. Most managed and many unmanaged |
| 2762 | 2815 | switches currently available support 802.3ad. |
| 2763 | 2816 | |
| 2764 | − The active-backup mode should work with any Layer-II switch. | |
| 2817 | +The active-backup mode should work with any Layer-II switch. | |
| 2765 | 2818 | |
| 2766 | 2819 | 8. Where does a bonding device get its MAC address from? |
| 2820 | +--------------------------------------------------------- | |
| 2767 | 2821 | |
| 2768 | − When using slave devices that have fixed MAC addresses, or when | |
| 2822 | +When using slave devices that have fixed MAC addresses, or when | |
| 2769 | 2823 | the fail_over_mac option is enabled, the bonding device's MAC address is |
| 2770 | 2824 | the MAC address of the active slave. |
| 2771 | 2825 | |
| 2772 | − For other configurations, if not explicitly configured (with | |
| 2826 | +For other configurations, if not explicitly configured (with | |
| 2773 | 2827 | ifconfig or ip link), the MAC address of the bonding device is taken from |
| 2774 | 2828 | its first slave device. This MAC address is then passed to all following |
| 2775 | 2829 | slaves and remains persistent (even if the first slave is removed) until |
| 2776 | 2830 | the bonding device is brought down or reconfigured. |
| 2777 | 2831 | |
| 2778 | − If you wish to change the MAC address, you can set it with | |
| 2779 | −ifconfig or ip link: | |
| 2832 | +If you wish to change the MAC address, you can set it with | |
| 2833 | +ifconfig or ip link:: | |
| 2780 | 2834 | |
| 2781 | −# ifconfig bond0 hw ether 00:11:22:33:44:55 | |
| 2835 | + # ifconfig bond0 hw ether 00:11:22:33:44:55 | |
| 2782 | 2836 | |
| 2783 | −# ip link set bond0 address 66:77:88:99:aa:bb | |
| 2837 | + # ip link set bond0 address 66:77:88:99:aa:bb | |
| 2784 | 2838 | |
| 2785 | − The MAC address can be also changed by bringing down/up the | |
| 2786 | −device and then changing its slaves (or their order): | |
| 2839 | +The MAC address can be also changed by bringing down/up the | |
| 2840 | +device and then changing its slaves (or their order):: | |
| 2787 | 2841 | |
| 2788 | −# ifconfig bond0 down ; modprobe -r bonding | |
| 2789 | −# ifconfig bond0 .... up | |
| 2790 | −# ifenslave bond0 eth... | |
| 2842 | + # ifconfig bond0 down ; modprobe -r bonding | |
| 2843 | + # ifconfig bond0 .... up | |
| 2844 | + # ifenslave bond0 eth... | |
| 2791 | 2845 | |
| 2792 | − This method will automatically take the address from the next | |
| 2846 | +This method will automatically take the address from the next | |
| 2793 | 2847 | slave that is added. |
| 2794 | 2848 | |
| 2795 | − To restore your slaves' MAC addresses, you need to detach them | |
| 2796 | −from the bond (`ifenslave -d bond0 eth0'). The bonding driver will | |
| 2849 | +To restore your slaves' MAC addresses, you need to detach them | |
| 2850 | +from the bond (``ifenslave -d bond0 eth0``). The bonding driver will | |
| 2797 | 2851 | then restore the MAC addresses that the slaves had before they were |
| 2798 | 2852 | enslaved. |
| 2799 | 2853 | |
| 2800 | 2854 | 16. Resources and Links |
| 2801 | 2855 | ======================= |
| 2802 | 2856 | |
| 2803 | − The latest version of the bonding driver can be found in the latest | |
| 2857 | +The latest version of the bonding driver can be found in the latest | |
| 2804 | 2858 | version of the linux kernel, found on http://kernel.org |
| 2805 | 2859 | |
| 2806 | − The latest version of this document can be found in the latest kernel | |
| 2807 | −source (named Documentation/networking/bonding.txt). | |
| 2860 | +The latest version of this document can be found in the latest kernel | |
| 2861 | +source (named Documentation/networking/bonding.rst). | |
| 2808 | 2862 | |
| 2809 | − Discussions regarding the usage of the bonding driver take place on the | |
| 2863 | +Discussions regarding the usage of the bonding driver take place on the | |
| 2810 | 2864 | bonding-devel mailing list, hosted at sourceforge.net. If you have questions or |
| 2811 | 2865 | problems, post them to the list. The list address is: |
| 2812 | 2866 | |
| 2813 | 2867 | bonding-devel@lists.sourceforge.net |
| 2814 | 2868 | |
| 2815 | − The administrative interface (to subscribe or unsubscribe) can | |
| 2869 | +The administrative interface (to subscribe or unsubscribe) can | |
| 2816 | 2870 | be found at: |
| 2817 | 2871 | |
| 2818 | 2872 | https://lists.sourceforge.net/lists/listinfo/bonding-devel |
| 2819 | 2873 | |
| 2820 | − Discussions regarding the development of the bonding driver take place | |
| 2874 | +Discussions regarding the development of the bonding driver take place | |
| 2821 | 2875 | on the main Linux network mailing list, hosted at vger.kernel.org. The list |
| 2822 | 2876 | address is: |
| 2823 | 2877 | |
| 2824 | 2878 | netdev@vger.kernel.org |
| 2825 | 2879 | |
| 2826 | − The administrative interface (to subscribe or unsubscribe) can | |
| 2880 | +The administrative interface (to subscribe or unsubscribe) can | |
| 2827 | 2881 | be found at: |
| 2828 | 2882 | |
| 2829 | 2883 | http://vger.kernel.org/vger-lists.html#netdev |
| 2830 | 2884 | |
| 2831 | 2885 | Donald Becker's Ethernet Drivers and diag programs may be found at : |
| 2832 | − - http://web.archive.org/web/*/http://www.scyld.com/network/ | |
| 2886 | + | |
| 2887 | + - http://web.archive.org/web/%2E/http://www.scyld.com/network/ | |
| 2833 | 2888 | |
| 2834 | 2889 | You will also find a lot of information regarding Ethernet, NWay, MII, |
| 2835 | 2890 | etc. at www.scyld.com. |
| 2836 | − | |
| 2837 | −-- END -- | |
| @@ -1,5 +1,3 @@ | ||
| 1 | −:orphan: | |
| 2 | − | |
| 3 | 1 | .. SPDX-License-Identifier: GPL-2.0 |
| 4 | 2 | .. include:: <isonum.txt> |
| 5 | 3 | |
| @@ -0,0 +1,13 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +CAIF | |
| 4 | +==== | |
| 5 | + | |
| 6 | +Contents: | |
| 7 | + | |
| 8 | +.. toctree:: | |
| 9 | + :maxdepth: 2 | |
| 10 | + | |
| 11 | + linux_caif | |
| 12 | + caif | |
| 13 | + spi_porting | |
| @@ -1,12 +1,19 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | +.. include:: <isonum.txt> | |
| 3 | + | |
| 4 | +========== | |
| 1 | 5 | Linux CAIF |
| 2 | −=========== | |
| 3 | −copyright (C) ST-Ericsson AB 2010 | |
| 4 | −Author: Sjur Brendeland/ sjur.brandeland@stericsson.com | |
| 5 | −License terms: GNU General Public License (GPL) version 2 | |
| 6 | +========== | |
| 7 | + | |
| 8 | +Copyright |copy| ST-Ericsson AB 2010 | |
| 9 | + | |
| 10 | +:Author: Sjur Brendeland/ sjur.brandeland@stericsson.com | |
| 11 | +:License terms: GNU General Public License (GPL) version 2 | |
| 6 | 12 | |
| 7 | 13 | |
| 8 | 14 | Introduction |
| 9 | −------------ | |
| 15 | +============ | |
| 16 | + | |
| 10 | 17 | CAIF is a MUX protocol used by ST-Ericsson cellular modems for |
| 11 | 18 | communication between Modem and host. The host processes can open virtual AT |
| 12 | 19 | channels, initiate GPRS Data connections, Video channels and Utility Channels. |
| @@ -16,13 +23,16 @@ ST-Ericsson modems support a number of transports between modem · 3 unmodified lines | ||
| 16 | 23 | and host. Currently, UART and Loopback are available for Linux. |
| 17 | 24 | |
| 18 | 25 | |
| 19 | −Architecture: | |
| 20 | −------------ | |
| 26 | +Architecture | |
| 27 | +============ | |
| 28 | + | |
| 21 | 29 | The implementation of CAIF is divided into: |
| 30 | + | |
| 22 | 31 | * CAIF Socket Layer and GPRS IP Interface. |
| 23 | 32 | * CAIF Core Protocol Implementation |
| 24 | 33 | * CAIF Link Layer, implemented as NET devices. |
| 25 | 34 | |
| 35 | +:: | |
| 26 | 36 | |
| 27 | 37 | RTNL |
| 28 | 38 | ! |
| @@ -46,12 +56,12 @@ The implementation of CAIF is divided into: · 17 unmodified lines | ||
| 46 | 56 | |
| 47 | 57 | |
| 48 | 58 | |
| 49 | −I M P L E M E N T A T I O N | |
| 50 | −=========================== | |
| 59 | +Implementation | |
| 60 | +============== | |
| 51 | 61 | |
| 52 | 62 | |
| 53 | 63 | CAIF Core Protocol Layer |
| 54 | −========================================= | |
| 64 | +------------------------ | |
| 55 | 65 | |
| 56 | 66 | CAIF Core layer implements the CAIF protocol as defined by ST-Ericsson. |
| 57 | 67 | It implements the CAIF protocol stack in a layered approach, where |
| @@ -59,8 +69,11 @@ each layer described in the specification is implemented as a separate layer. · 1 unmodified line | ||
| 59 | 69 | The architecture is inspired by the design patterns "Protocol Layer" and |
| 60 | 70 | "Protocol Packet". |
| 61 | 71 | |
| 62 | −== CAIF structure == | |
| 72 | +CAIF structure | |
| 73 | +^^^^^^^^^^^^^^ | |
| 74 | + | |
| 63 | 75 | The Core CAIF implementation contains: |
| 76 | + | |
| 64 | 77 | - Simple implementation of CAIF. |
| 65 | 78 | - Layered architecture (a la Streams), each layer in the CAIF |
| 66 | 79 | specification is implemented in a separate c-file. |
| @@ -73,7 +86,8 @@ The Core CAIF implementation contains: · 6 unmodified lines | ||
| 73 | 86 | to the called function (except for framing layers' receive function) |
| 74 | 87 | |
| 75 | 88 | Layered Architecture |
| 76 | −-------------------- | |
| 89 | +==================== | |
| 90 | + | |
| 77 | 91 | The CAIF protocol can be divided into two parts: Support functions and Protocol |
| 78 | 92 | Implementation. The support functions include: |
| 79 | 93 | |
| @@ -112,7 +126,7 @@ The CAIF Protocol implementation contains: · 32 unmodified lines | ||
| 112 | 126 | - CFSERL CAIF Serial layer. Handles concatenation/split of frames |
| 113 | 127 | into CAIF Frames with correct length. |
| 114 | 128 | |
| 115 | − | |
| 129 | +:: | |
| 116 | 130 | |
| 117 | 131 | +---------+ |
| 118 | 132 | | Config | |
| @@ -143,18 +157,24 @@ The CAIF Protocol implementation contains: · 24 unmodified lines | ||
| 143 | 157 | |
| 144 | 158 | |
| 145 | 159 | In this layered approach the following "rules" apply. |
| 160 | + | |
| 146 | 161 | - All layers embed the same structure "struct cflayer" |
| 147 | 162 | - A layer does not depend on any other layer's private data. |
| 148 | − - Layers are stacked by setting the pointers | |
| 163 | + - Layers are stacked by setting the pointers:: | |
| 164 | + | |
| 149 | 165 | layer->up , layer->dn |
| 150 | − - In order to send data upwards, each layer should do | |
| 166 | + | |
| 167 | + - In order to send data upwards, each layer should do:: | |
| 168 | + | |
| 151 | 169 | layer->up->receive(layer->up, packet); |
| 152 | − - In order to send data downwards, each layer should do | |
| 170 | + | |
| 171 | + - In order to send data downwards, each layer should do:: | |
| 172 | + | |
| 153 | 173 | layer->dn->transmit(layer->dn, packet); |
| 154 | 174 | |
| 155 | 175 | |
| 156 | 176 | CAIF Socket and IP interface |
| 157 | −=========================== | |
| 177 | +============================ | |
| 158 | 178 | |
| 159 | 179 | The IP interface and CAIF socket API are implemented on top of the |
| 160 | 180 | CAIF Core protocol. The IP Interface and CAIF socket have an instance of |
| @@ -0,0 +1,229 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +================ | |
| 4 | +CAIF SPI porting | |
| 5 | +================ | |
| 6 | + | |
| 7 | +CAIF SPI basics | |
| 8 | +=============== | |
| 9 | + | |
| 10 | +Running CAIF over SPI needs some extra setup, owing to the nature of SPI. | |
| 11 | +Two extra GPIOs have been added in order to negotiate the transfers | |
| 12 | +between the master and the slave. The minimum requirement for running | |
| 13 | +CAIF over SPI is a SPI slave chip and two GPIOs (more details below). | |
| 14 | +Please note that running as a slave implies that you need to keep up | |
| 15 | +with the master clock. An overrun or underrun event is fatal. | |
| 16 | + | |
| 17 | +CAIF SPI framework | |
| 18 | +================== | |
| 19 | + | |
| 20 | +To make porting as easy as possible, the CAIF SPI has been divided in | |
| 21 | +two parts. The first part (called the interface part) deals with all | |
| 22 | +generic functionality such as length framing, SPI frame negotiation | |
| 23 | +and SPI frame delivery and transmission. The other part is the CAIF | |
| 24 | +SPI slave device part, which is the module that you have to write if | |
| 25 | +you want to run SPI CAIF on a new hardware. This part takes care of | |
| 26 | +the physical hardware, both with regard to SPI and to GPIOs. | |
| 27 | + | |
| 28 | +- Implementing a CAIF SPI device: | |
| 29 | + | |
| 30 | + - Functionality provided by the CAIF SPI slave device: | |
| 31 | + | |
| 32 | + In order to implement a SPI device you will, as a minimum, | |
| 33 | + need to implement the following | |
| 34 | + functions: | |
| 35 | + | |
| 36 | + :: | |
| 37 | + | |
| 38 | + int (*init_xfer) (struct cfspi_xfer * xfer, struct cfspi_dev *dev): | |
| 39 | + | |
| 40 | + This function is called by the CAIF SPI interface to give | |
| 41 | + you a chance to set up your hardware to be ready to receive | |
| 42 | + a stream of data from the master. The xfer structure contains | |
| 43 | + both physical and logical addresses, as well as the total length | |
| 44 | + of the transfer in both directions.The dev parameter can be used | |
| 45 | + to map to different CAIF SPI slave devices. | |
| 46 | + | |
| 47 | + :: | |
| 48 | + | |
| 49 | + void (*sig_xfer) (bool xfer, struct cfspi_dev *dev): | |
| 50 | + | |
| 51 | + This function is called by the CAIF SPI interface when the output | |
| 52 | + (SPI_INT) GPIO needs to change state. The boolean value of the xfer | |
| 53 | + variable indicates whether the GPIO should be asserted (HIGH) or | |
| 54 | + deasserted (LOW). The dev parameter can be used to map to different CAIF | |
| 55 | + SPI slave devices. | |
| 56 | + | |
| 57 | + - Functionality provided by the CAIF SPI interface: | |
| 58 | + | |
| 59 | + :: | |
| 60 | + | |
| 61 | + void (*ss_cb) (bool assert, struct cfspi_ifc *ifc); | |
| 62 | + | |
| 63 | + This function is called by the CAIF SPI slave device in order to | |
| 64 | + signal a change of state of the input GPIO (SS) to the interface. | |
| 65 | + Only active edges are mandatory to be reported. | |
| 66 | + This function can be called from IRQ context (recommended in order | |
| 67 | + not to introduce latency). The ifc parameter should be the pointer | |
| 68 | + returned from the platform probe function in the SPI device structure. | |
| 69 | + | |
| 70 | + :: | |
| 71 | + | |
| 72 | + void (*xfer_done_cb) (struct cfspi_ifc *ifc); | |
| 73 | + | |
| 74 | + This function is called by the CAIF SPI slave device in order to | |
| 75 | + report that a transfer is completed. This function should only be | |
| 76 | + called once both the transmission and the reception are completed. | |
| 77 | + This function can be called from IRQ context (recommended in order | |
| 78 | + not to introduce latency). The ifc parameter should be the pointer | |
| 79 | + returned from the platform probe function in the SPI device structure. | |
| 80 | + | |
| 81 | + - Connecting the bits and pieces: | |
| 82 | + | |
| 83 | + - Filling in the SPI slave device structure: | |
| 84 | + | |
| 85 | + Connect the necessary callback functions. | |
| 86 | + | |
| 87 | + Indicate clock speed (used to calculate toggle delays). | |
| 88 | + | |
| 89 | + Chose a suitable name (helps debugging if you use several CAIF | |
| 90 | + SPI slave devices). | |
| 91 | + | |
| 92 | + Assign your private data (can be used to map to your | |
| 93 | + structure). | |
| 94 | + | |
| 95 | + - Filling in the SPI slave platform device structure: | |
| 96 | + | |
| 97 | + Add name of driver to connect to ("cfspi_sspi"). | |
| 98 | + | |
| 99 | + Assign the SPI slave device structure as platform data. | |
| 100 | + | |
| 101 | +Padding | |
| 102 | +======= | |
| 103 | + | |
| 104 | +In order to optimize throughput, a number of SPI padding options are provided. | |
| 105 | +Padding can be enabled independently for uplink and downlink transfers. | |
| 106 | +Padding can be enabled for the head, the tail and for the total frame size. | |
| 107 | +The padding needs to be correctly configured on both sides of the link. | |
| 108 | +The padding can be changed via module parameters in cfspi_sspi.c or via | |
| 109 | +the sysfs directory of the cfspi_sspi driver (before device registration). | |
| 110 | + | |
| 111 | +- CAIF SPI device template:: | |
| 112 | + | |
| 113 | + /* | |
| 114 | + * Copyright (C) ST-Ericsson AB 2010 | |
| 115 | + * Author: Daniel Martensson / Daniel.Martensson@stericsson.com | |
| 116 | + * License terms: GNU General Public License (GPL), version 2. | |
| 117 | + * | |
| 118 | + */ | |
| 119 | + | |
| 120 | + #include <linux/init.h> | |
| 121 | + #include <linux/module.h> | |
| 122 | + #include <linux/device.h> | |
| 123 | + #include <linux/wait.h> | |
| 124 | + #include <linux/interrupt.h> | |
| 125 | + #include <linux/dma-mapping.h> | |
| 126 | + #include <net/caif/caif_spi.h> | |
| 127 | + | |
| 128 | + MODULE_LICENSE("GPL"); | |
| 129 | + | |
| 130 | + struct sspi_struct { | |
| 131 | + struct cfspi_dev sdev; | |
| 132 | + struct cfspi_xfer *xfer; | |
| 133 | + }; | |
| 134 | + | |
| 135 | + static struct sspi_struct slave; | |
| 136 | + static struct platform_device slave_device; | |
| 137 | + | |
| 138 | + static irqreturn_t sspi_irq(int irq, void *arg) | |
| 139 | + { | |
| 140 | + /* You only need to trigger on an edge to the active state of the | |
| 141 | + * SS signal. Once a edge is detected, the ss_cb() function should be | |
| 142 | + * called with the parameter assert set to true. It is OK | |
| 143 | + * (and even advised) to call the ss_cb() function in IRQ context in | |
| 144 | + * order not to add any delay. */ | |
| 145 | + | |
| 146 | + return IRQ_HANDLED; | |
| 147 | + } | |
| 148 | + | |
| 149 | + static void sspi_complete(void *context) | |
| 150 | + { | |
| 151 | + /* Normally the DMA or the SPI framework will call you back | |
| 152 | + * in something similar to this. The only thing you need to | |
| 153 | + * do is to call the xfer_done_cb() function, providing the pointer | |
| 154 | + * to the CAIF SPI interface. It is OK to call this function | |
| 155 | + * from IRQ context. */ | |
| 156 | + } | |
| 157 | + | |
| 158 | + static int sspi_init_xfer(struct cfspi_xfer *xfer, struct cfspi_dev *dev) | |
| 159 | + { | |
| 160 | + /* Store transfer info. For a normal implementation you should | |
| 161 | + * set up your DMA here and make sure that you are ready to | |
| 162 | + * receive the data from the master SPI. */ | |
| 163 | + | |
| 164 | + struct sspi_struct *sspi = (struct sspi_struct *)dev->priv; | |
| 165 | + | |
| 166 | + sspi->xfer = xfer; | |
| 167 | + | |
| 168 | + return 0; | |
| 169 | + } | |
| 170 | + | |
| 171 | + void sspi_sig_xfer(bool xfer, struct cfspi_dev *dev) | |
| 172 | + { | |
| 173 | + /* If xfer is true then you should assert the SPI_INT to indicate to | |
| 174 | + * the master that you are ready to receive the data from the master | |
| 175 | + * SPI. If xfer is false then you should de-assert SPI_INT to indicate | |
| 176 | + * that the transfer is done. | |
| 177 | + */ | |
| 178 | + | |
| 179 | + struct sspi_struct *sspi = (struct sspi_struct *)dev->priv; | |
| 180 | + } | |
| 181 | + | |
| 182 | + static void sspi_release(struct device *dev) | |
| 183 | + { | |
| 184 | + /* | |
| 185 | + * Here you should release your SPI device resources. | |
| 186 | + */ | |
| 187 | + } | |
| 188 | + | |
| 189 | + static int __init sspi_init(void) | |
| 190 | + { | |
| 191 | + /* Here you should initialize your SPI device by providing the | |
| 192 | + * necessary functions, clock speed, name and private data. Once | |
| 193 | + * done, you can register your device with the | |
| 194 | + * platform_device_register() function. This function will return | |
| 195 | + * with the CAIF SPI interface initialized. This is probably also | |
| 196 | + * the place where you should set up your GPIOs, interrupts and SPI | |
| 197 | + * resources. */ | |
| 198 | + | |
| 199 | + int res = 0; | |
| 200 | + | |
| 201 | + /* Initialize slave device. */ | |
| 202 | + slave.sdev.init_xfer = sspi_init_xfer; | |
| 203 | + slave.sdev.sig_xfer = sspi_sig_xfer; | |
| 204 | + slave.sdev.clk_mhz = 13; | |
| 205 | + slave.sdev.priv = &slave; | |
| 206 | + slave.sdev.name = "spi_sspi"; | |
| 207 | + slave_device.dev.release = sspi_release; | |
| 208 | + | |
| 209 | + /* Initialize platform device. */ | |
| 210 | + slave_device.name = "cfspi_sspi"; | |
| 211 | + slave_device.dev.platform_data = &slave.sdev; | |
| 212 | + | |
| 213 | + /* Register platform device. */ | |
| 214 | + res = platform_device_register(&slave_device); | |
| 215 | + if (res) { | |
| 216 | + printk(KERN_WARNING "sspi_init: failed to register dev.\n"); | |
| 217 | + return -ENODEV; | |
| 218 | + } | |
| 219 | + | |
| 220 | + return res; | |
| 221 | + } | |
| 222 | + | |
| 223 | + static void __exit sspi_exit(void) | |
| 224 | + { | |
| 225 | + platform_device_del(&slave_device); | |
| 226 | + } | |
| 227 | + | |
| 228 | + module_init(sspi_init); | |
| 229 | + module_exit(sspi_exit); | |
| @@ -1,208 +0,0 @@ | ||
| 1 | −- CAIF SPI porting - | |
| 2 | − | |
| 3 | −- CAIF SPI basics: | |
| 4 | − | |
| 5 | −Running CAIF over SPI needs some extra setup, owing to the nature of SPI. | |
| 6 | −Two extra GPIOs have been added in order to negotiate the transfers | |
| 7 | − between the master and the slave. The minimum requirement for running | |
| 8 | −CAIF over SPI is a SPI slave chip and two GPIOs (more details below). | |
| 9 | −Please note that running as a slave implies that you need to keep up | |
| 10 | −with the master clock. An overrun or underrun event is fatal. | |
| 11 | − | |
| 12 | −- CAIF SPI framework: | |
| 13 | − | |
| 14 | −To make porting as easy as possible, the CAIF SPI has been divided in | |
| 15 | −two parts. The first part (called the interface part) deals with all | |
| 16 | −generic functionality such as length framing, SPI frame negotiation | |
| 17 | −and SPI frame delivery and transmission. The other part is the CAIF | |
| 18 | −SPI slave device part, which is the module that you have to write if | |
| 19 | −you want to run SPI CAIF on a new hardware. This part takes care of | |
| 20 | −the physical hardware, both with regard to SPI and to GPIOs. | |
| 21 | − | |
| 22 | −- Implementing a CAIF SPI device: | |
| 23 | − | |
| 24 | − - Functionality provided by the CAIF SPI slave device: | |
| 25 | − | |
| 26 | − In order to implement a SPI device you will, as a minimum, | |
| 27 | − need to implement the following | |
| 28 | − functions: | |
| 29 | − | |
| 30 | − int (*init_xfer) (struct cfspi_xfer * xfer, struct cfspi_dev *dev): | |
| 31 | − | |
| 32 | − This function is called by the CAIF SPI interface to give | |
| 33 | − you a chance to set up your hardware to be ready to receive | |
| 34 | − a stream of data from the master. The xfer structure contains | |
| 35 | − both physical and logical addresses, as well as the total length | |
| 36 | − of the transfer in both directions.The dev parameter can be used | |
| 37 | − to map to different CAIF SPI slave devices. | |
| 38 | − | |
| 39 | − void (*sig_xfer) (bool xfer, struct cfspi_dev *dev): | |
| 40 | − | |
| 41 | − This function is called by the CAIF SPI interface when the output | |
| 42 | − (SPI_INT) GPIO needs to change state. The boolean value of the xfer | |
| 43 | − variable indicates whether the GPIO should be asserted (HIGH) or | |
| 44 | − deasserted (LOW). The dev parameter can be used to map to different CAIF | |
| 45 | − SPI slave devices. | |
| 46 | − | |
| 47 | − - Functionality provided by the CAIF SPI interface: | |
| 48 | − | |
| 49 | − void (*ss_cb) (bool assert, struct cfspi_ifc *ifc); | |
| 50 | − | |
| 51 | − This function is called by the CAIF SPI slave device in order to | |
| 52 | − signal a change of state of the input GPIO (SS) to the interface. | |
| 53 | − Only active edges are mandatory to be reported. | |
| 54 | − This function can be called from IRQ context (recommended in order | |
| 55 | − not to introduce latency). The ifc parameter should be the pointer | |
| 56 | − returned from the platform probe function in the SPI device structure. | |
| 57 | − | |
| 58 | − void (*xfer_done_cb) (struct cfspi_ifc *ifc); | |
| 59 | − | |
| 60 | − This function is called by the CAIF SPI slave device in order to | |
| 61 | − report that a transfer is completed. This function should only be | |
| 62 | − called once both the transmission and the reception are completed. | |
| 63 | − This function can be called from IRQ context (recommended in order | |
| 64 | − not to introduce latency). The ifc parameter should be the pointer | |
| 65 | − returned from the platform probe function in the SPI device structure. | |
| 66 | − | |
| 67 | − - Connecting the bits and pieces: | |
| 68 | − | |
| 69 | − - Filling in the SPI slave device structure: | |
| 70 | − | |
| 71 | − Connect the necessary callback functions. | |
| 72 | − Indicate clock speed (used to calculate toggle delays). | |
| 73 | − Chose a suitable name (helps debugging if you use several CAIF | |
| 74 | − SPI slave devices). | |
| 75 | − Assign your private data (can be used to map to your structure). | |
| 76 | − | |
| 77 | − - Filling in the SPI slave platform device structure: | |
| 78 | − Add name of driver to connect to ("cfspi_sspi"). | |
| 79 | − Assign the SPI slave device structure as platform data. | |
| 80 | − | |
| 81 | −- Padding: | |
| 82 | − | |
| 83 | −In order to optimize throughput, a number of SPI padding options are provided. | |
| 84 | −Padding can be enabled independently for uplink and downlink transfers. | |
| 85 | −Padding can be enabled for the head, the tail and for the total frame size. | |
| 86 | −The padding needs to be correctly configured on both sides of the link. | |
| 87 | −The padding can be changed via module parameters in cfspi_sspi.c or via | |
| 88 | −the sysfs directory of the cfspi_sspi driver (before device registration). | |
| 89 | − | |
| 90 | −- CAIF SPI device template: | |
| 91 | − | |
| 92 | −/* | |
| 93 | − * Copyright (C) ST-Ericsson AB 2010 | |
| 94 | − * Author: Daniel Martensson / Daniel.Martensson@stericsson.com | |
| 95 | − * License terms: GNU General Public License (GPL), version 2. | |
| 96 | − * | |
| 97 | − */ | |
| 98 | − | |
| 99 | −#include <linux/init.h> | |
| 100 | −#include <linux/module.h> | |
| 101 | −#include <linux/device.h> | |
| 102 | −#include <linux/wait.h> | |
| 103 | −#include <linux/interrupt.h> | |
| 104 | −#include <linux/dma-mapping.h> | |
| 105 | −#include <net/caif/caif_spi.h> | |
| 106 | − | |
| 107 | −MODULE_LICENSE("GPL"); | |
| 108 | − | |
| 109 | −struct sspi_struct { | |
| 110 | − struct cfspi_dev sdev; | |
| 111 | − struct cfspi_xfer *xfer; | |
| 112 | −}; | |
| 113 | − | |
| 114 | −static struct sspi_struct slave; | |
| 115 | −static struct platform_device slave_device; | |
| 116 | − | |
| 117 | −static irqreturn_t sspi_irq(int irq, void *arg) | |
| 118 | −{ | |
| 119 | − /* You only need to trigger on an edge to the active state of the | |
| 120 | − * SS signal. Once a edge is detected, the ss_cb() function should be | |
| 121 | − * called with the parameter assert set to true. It is OK | |
| 122 | − * (and even advised) to call the ss_cb() function in IRQ context in | |
| 123 | − * order not to add any delay. */ | |
| 124 | − | |
| 125 | − return IRQ_HANDLED; | |
| 126 | −} | |
| 127 | − | |
| 128 | −static void sspi_complete(void *context) | |
| 129 | −{ | |
| 130 | − /* Normally the DMA or the SPI framework will call you back | |
| 131 | − * in something similar to this. The only thing you need to | |
| 132 | − * do is to call the xfer_done_cb() function, providing the pointer | |
| 133 | − * to the CAIF SPI interface. It is OK to call this function | |
| 134 | − * from IRQ context. */ | |
| 135 | −} | |
| 136 | − | |
| 137 | −static int sspi_init_xfer(struct cfspi_xfer *xfer, struct cfspi_dev *dev) | |
| 138 | −{ | |
| 139 | − /* Store transfer info. For a normal implementation you should | |
| 140 | − * set up your DMA here and make sure that you are ready to | |
| 141 | − * receive the data from the master SPI. */ | |
| 142 | − | |
| 143 | − struct sspi_struct *sspi = (struct sspi_struct *)dev->priv; | |
| 144 | − | |
| 145 | − sspi->xfer = xfer; | |
| 146 | − | |
| 147 | − return 0; | |
| 148 | −} | |
| 149 | − | |
| 150 | −void sspi_sig_xfer(bool xfer, struct cfspi_dev *dev) | |
| 151 | −{ | |
| 152 | − /* If xfer is true then you should assert the SPI_INT to indicate to | |
| 153 | − * the master that you are ready to receive the data from the master | |
| 154 | − * SPI. If xfer is false then you should de-assert SPI_INT to indicate | |
| 155 | − * that the transfer is done. | |
| 156 | − */ | |
| 157 | − | |
| 158 | − struct sspi_struct *sspi = (struct sspi_struct *)dev->priv; | |
| 159 | −} | |
| 160 | − | |
| 161 | −static void sspi_release(struct device *dev) | |
| 162 | −{ | |
| 163 | − /* | |
| 164 | − * Here you should release your SPI device resources. | |
| 165 | − */ | |
| 166 | −} | |
| 167 | − | |
| 168 | −static int __init sspi_init(void) | |
| 169 | −{ | |
| 170 | − /* Here you should initialize your SPI device by providing the | |
| 171 | − * necessary functions, clock speed, name and private data. Once | |
| 172 | − * done, you can register your device with the | |
| 173 | − * platform_device_register() function. This function will return | |
| 174 | − * with the CAIF SPI interface initialized. This is probably also | |
| 175 | − * the place where you should set up your GPIOs, interrupts and SPI | |
| 176 | − * resources. */ | |
| 177 | − | |
| 178 | − int res = 0; | |
| 179 | − | |
| 180 | − /* Initialize slave device. */ | |
| 181 | − slave.sdev.init_xfer = sspi_init_xfer; | |
| 182 | − slave.sdev.sig_xfer = sspi_sig_xfer; | |
| 183 | − slave.sdev.clk_mhz = 13; | |
| 184 | − slave.sdev.priv = &slave; | |
| 185 | − slave.sdev.name = "spi_sspi"; | |
| 186 | − slave_device.dev.release = sspi_release; | |
| 187 | − | |
| 188 | − /* Initialize platform device. */ | |
| 189 | − slave_device.name = "cfspi_sspi"; | |
| 190 | − slave_device.dev.platform_data = &slave.sdev; | |
| 191 | − | |
| 192 | − /* Register platform device. */ | |
| 193 | − res = platform_device_register(&slave_device); | |
| 194 | − if (res) { | |
| 195 | − printk(KERN_WARNING "sspi_init: failed to register dev.\n"); | |
| 196 | − return -ENODEV; | |
| 197 | − } | |
| 198 | − | |
| 199 | − return res; | |
| 200 | −} | |
| 201 | − | |
| 202 | −static void __exit sspi_exit(void) | |
| 203 | −{ | |
| 204 | − platform_device_del(&slave_device); | |
| 205 | −} | |
| 206 | − | |
| 207 | −module_init(sspi_init); | |
| 208 | −module_exit(sspi_exit); | |
| @@ -1058,7 +1058,7 @@ drivers you mainly have to deal with: · 1057 unmodified lines | ||
| 1058 | 1058 | - TX: Put the CAN frame from the socket buffer to the CAN controller. |
| 1059 | 1059 | - RX: Put the CAN frame from the CAN controller to the socket buffer. |
| 1060 | 1060 | |
| 1061 | −See e.g. at Documentation/networking/netdevices.txt . The differences | |
| 1061 | +See e.g. at Documentation/networking/netdevices.rst . The differences | |
| 1062 | 1062 | for writing CAN network device driver are described below: |
| 1063 | 1063 | |
| 1064 | 1064 | |
| @@ -1,5 +1,8 @@ | ||
| 1 | − cdc_mbim - Driver for CDC MBIM Mobile Broadband modems | |
| 2 | − ======================================================== | |
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +====================================================== | |
| 4 | +cdc_mbim - Driver for CDC MBIM Mobile Broadband modems | |
| 5 | +====================================================== | |
| 3 | 6 | |
| 4 | 7 | The cdc_mbim driver supports USB devices conforming to the "Universal |
| 5 | 8 | Serial Bus Communications Class Subclass Specification for Mobile |
| @@ -19,9 +22,9 @@ by a cdc_ncm driver parameter: · 13 unmodified lines | ||
| 19 | 22 | |
| 20 | 23 | prefer_mbim |
| 21 | 24 | ----------- |
| 22 | −Type: Boolean | |
| 23 | −Valid Range: N/Y (0-1) | |
| 24 | −Default Value: Y (MBIM is preferred) | |
| 25 | +:Type: Boolean | |
| 26 | +:Valid Range: N/Y (0-1) | |
| 27 | +:Default Value: Y (MBIM is preferred) | |
| 25 | 28 | |
| 26 | 29 | This parameter sets the system policy for NCM/MBIM functions. Such |
| 27 | 30 | functions will be handled by either the cdc_ncm driver or the cdc_mbim |
| @@ -44,11 +47,13 @@ userspace MBIM management application always is required to enable a · 16 unmodified lines | ||
| 44 | 47 | MBIM function. |
| 45 | 48 | |
| 46 | 49 | Such userspace applications includes, but are not limited to: |
| 50 | + | |
| 47 | 51 | - mbimcli (included with the libmbim [3] library), and |
| 48 | 52 | - ModemManager [4] |
| 49 | 53 | |
| 50 | 54 | Establishing a MBIM IP session reequires at least these actions by the |
| 51 | 55 | management application: |
| 56 | + | |
| 52 | 57 | - open the control channel |
| 53 | 58 | - configure network connection settings |
| 54 | 59 | - connect to network |
| @@ -76,7 +81,7 @@ complies with all the control channel requirements in [1]. · 21 unmodified lines | ||
| 76 | 81 | |
| 77 | 82 | The cdc-wdmX device is created as a child of the MBIM control |
| 78 | 83 | interface USB device. The character device associated with a specific |
| 79 | −MBIM function can be looked up using sysfs. For example: | |
| 84 | +MBIM function can be looked up using sysfs. For example:: | |
| 80 | 85 | |
| 81 | 86 | bjorn@nemi:~$ ls /sys/bus/usb/drivers/cdc_mbim/2-4:2.12/usbmisc |
| 82 | 87 | cdc-wdm0 |
| @@ -119,13 +124,15 @@ negotiated control message size. · 36 unmodified lines | ||
| 119 | 124 | |
| 120 | 125 | |
| 121 | 126 | /dev/cdc-wdmX ioctl() |
| 122 | −-------------------- | |
| 127 | +--------------------- | |
| 123 | 128 | IOCTL_WDM_MAX_COMMAND: Get Maximum Command Size |
| 124 | 129 | This ioctl returns the wMaxControlMessage field of the CDC MBIM |
| 125 | 130 | functional descriptor for MBIM devices. This is intended as a |
| 126 | 131 | convenience, eliminating the need to parse the USB descriptors from |
| 127 | 132 | userspace. |
| 128 | 133 | |
| 134 | +:: | |
| 135 | + | |
| 129 | 136 | #include <stdio.h> |
| 130 | 137 | #include <fcntl.h> |
| 131 | 138 | #include <sys/ioctl.h> |
| @@ -178,7 +185,7 @@ VLAN links prior to establishing MBIM IP sessions where the SessionId · 46 unmodified lines | ||
| 178 | 185 | is greater than 0. These links can be added by using the normal VLAN |
| 179 | 186 | kernel interfaces, either ioctl or netlink. |
| 180 | 187 | |
| 181 | −For example, adding a link for a MBIM IP session with SessionId 3: | |
| 188 | +For example, adding a link for a MBIM IP session with SessionId 3:: | |
| 182 | 189 | |
| 183 | 190 | ip link add link wwan0 name wwan0.3 type vlan id 3 |
| 184 | 191 | |
| @@ -207,6 +214,7 @@ the stream to the end user in an appropriate way for the stream type. · 22 unmodified lines | ||
| 207 | 214 | The network device ABI requires a dummy ethernet header for every DSS |
| 208 | 215 | data frame being transported. The contents of this header is |
| 209 | 216 | arbitrary, with the following exceptions: |
| 217 | + | |
| 210 | 218 | - TX frames using an IP protocol (0x0800 or 0x86dd) will be dropped |
| 211 | 219 | - RX frames will have the protocol field set to ETH_P_802_3 (but will |
| 212 | 220 | not be properly formatted 802.3 frames) |
| @@ -218,7 +226,7 @@ adding the dummy ethernet header on TX and stripping it on RX. · 5 unmodified lines | ||
| 218 | 226 | |
| 219 | 227 | This is a simple example using tools commonly available, exporting |
| 220 | 228 | DssSessionId 5 as a pty character device pointed to by a /dev/nmea |
| 221 | −symlink: | |
| 229 | +symlink:: | |
| 222 | 230 | |
| 223 | 231 | ip link add link wwan0 name wwan0.dss5 type vlan id 261 |
| 224 | 232 | ip link set dev wwan0.dss5 up |
| @@ -236,7 +244,7 @@ map frames to the correct DSS session and adding 18 byte VLAN ethernet · 11 unmodified lines | ||
| 236 | 244 | headers with the appropriate tag on TX. In this case using a socket |
| 237 | 245 | filter is recommended, matching only the DSS VLAN subset. This avoid |
| 238 | 246 | unnecessary copying of unrelated IP session data to userspace. For |
| 239 | −example: | |
| 247 | +example:: | |
| 240 | 248 | |
| 241 | 249 | static struct sock_filter dssfilter[] = { |
| 242 | 250 | /* use special negative offsets to get VLAN tag */ |
| @@ -249,11 +257,11 @@ example: · 6 unmodified lines | ||
| 249 | 257 | BPF_JUMP(BPF_JMP|BPF_JGE|BPF_K, 512, 3, 0), /* 511 is last DSS VLAN */ |
| 250 | 258 | |
| 251 | 259 | /* verify ethertype */ |
| 252 | − BPF_STMT(BPF_LD|BPF_H|BPF_ABS, 2 * ETH_ALEN), | |
| 253 | − BPF_JUMP(BPF_JMP|BPF_JEQ|BPF_K, ETH_P_802_3, 0, 1), | |
| 260 | + BPF_STMT(BPF_LD|BPF_H|BPF_ABS, 2 * ETH_ALEN), | |
| 261 | + BPF_JUMP(BPF_JMP|BPF_JEQ|BPF_K, ETH_P_802_3, 0, 1), | |
| 254 | 262 | |
| 255 | − BPF_STMT(BPF_RET|BPF_K, (u_int)-1), /* accept */ | |
| 256 | − BPF_STMT(BPF_RET|BPF_K, 0), /* ignore */ | |
| 263 | + BPF_STMT(BPF_RET|BPF_K, (u_int)-1), /* accept */ | |
| 264 | + BPF_STMT(BPF_RET|BPF_K, 0), /* ignore */ | |
| 257 | 265 | }; |
| 258 | 266 | |
| 259 | 267 | |
| @@ -266,6 +274,7 @@ network device. · 6 unmodified lines | ||
| 266 | 274 | |
| 267 | 275 | This mapping implies a few restrictions on multiplexed IPS and DSS |
| 268 | 276 | sessions, which may not always be practical: |
| 277 | + | |
| 269 | 278 | - no IPS or DSS session can use a frame size greater than the MTU on |
| 270 | 279 | IP session 0 |
| 271 | 280 | - no IPS or DSS session can be in the up state unless the network |
| @@ -280,7 +289,7 @@ device. · 8 unmodified lines | ||
| 280 | 289 | |
| 281 | 290 | Tip: It might be less confusing to the end user to name this VLAN |
| 282 | 291 | subdevice after the MBIM SessionID instead of the VLAN ID. For |
| 283 | −example: | |
| 292 | +example:: | |
| 284 | 293 | |
| 285 | 294 | ip link add link wwan0 name wwan0.0 type vlan id 4094 |
| 286 | 295 | |
| @@ -290,7 +299,7 @@ VLAN mapping · 3 unmodified lines | ||
| 290 | 299 | |
| 291 | 300 | Summarizing the cdc_mbim driver mapping described above, we have this |
| 292 | 301 | relationship between VLAN tags on the wwanY network device and MBIM |
| 293 | −sessions on the shared USB data channel: | |
| 302 | +sessions on the shared USB data channel:: | |
| 294 | 303 | |
| 295 | 304 | VLAN ID MBIM type MBIM SessionID Notes |
| 296 | 305 | --------------------------------------------------------- |
| @@ -310,30 +319,37 @@ sessions on the shared USB data channel: · 13 unmodified lines | ||
| 310 | 319 | References |
| 311 | 320 | ========== |
| 312 | 321 | |
| 313 | −[1] USB Implementers Forum, Inc. - "Universal Serial Bus | |
| 314 | − Communications Class Subclass Specification for Mobile Broadband | |
| 315 | − Interface Model", Revision 1.0 (Errata 1), May 1, 2013 | |
| 322 | + 1) USB Implementers Forum, Inc. - "Universal Serial Bus | |
| 323 | + Communications Class Subclass Specification for Mobile Broadband | |
| 324 | + Interface Model", Revision 1.0 (Errata 1), May 1, 2013 | |
| 325 | + | |
| 316 | 326 | - http://www.usb.org/developers/docs/devclass_docs/ |
| 317 | 327 | |
| 318 | −[2] USB Implementers Forum, Inc. - "Universal Serial Bus | |
| 319 | − Communications Class Subclass Specifications for Network Control | |
| 320 | − Model Devices", Revision 1.0 (Errata 1), November 24, 2010 | |
| 328 | + 2) USB Implementers Forum, Inc. - "Universal Serial Bus | |
| 329 | + Communications Class Subclass Specifications for Network Control | |
| 330 | + Model Devices", Revision 1.0 (Errata 1), November 24, 2010 | |
| 331 | + | |
| 321 | 332 | - http://www.usb.org/developers/docs/devclass_docs/ |
| 322 | 333 | |
| 323 | −[3] libmbim - "a glib-based library for talking to WWAN modems and | |
| 324 | − devices which speak the Mobile Interface Broadband Model (MBIM) | |
| 325 | − protocol" | |
| 334 | + 3) libmbim - "a glib-based library for talking to WWAN modems and | |
| 335 | + devices which speak the Mobile Interface Broadband Model (MBIM) | |
| 336 | + protocol" | |
| 337 | + | |
| 326 | 338 | - http://www.freedesktop.org/wiki/Software/libmbim/ |
| 327 | 339 | |
| 328 | −[4] ModemManager - "a DBus-activated daemon which controls mobile | |
| 329 | − broadband (2G/3G/4G) devices and connections" | |
| 340 | + 4) ModemManager - "a DBus-activated daemon which controls mobile | |
| 341 | + broadband (2G/3G/4G) devices and connections" | |
| 342 | + | |
| 330 | 343 | - http://www.freedesktop.org/wiki/Software/ModemManager/ |
| 331 | 344 | |
| 332 | −[5] "MBIM (Mobile Broadband Interface Model) Registry" | |
| 345 | + 5) "MBIM (Mobile Broadband Interface Model) Registry" | |
| 346 | + | |
| 333 | 347 | - http://compliance.usb.org/mbim/ |
| 334 | 348 | |
| 335 | −[6] "/sys/kernel/debug/usb/devices output format" | |
| 349 | + 6) "/sys/kernel/debug/usb/devices output format" | |
| 350 | + | |
| 336 | 351 | - Documentation/driver-api/usb/usb.rst |
| 337 | 352 | |
| 338 | −[7] "/sys/bus/usb/devices/.../descriptors" | |
| 353 | + 7) "/sys/bus/usb/devices/.../descriptors" | |
| 354 | + | |
| 339 | 355 | - Documentation/ABI/stable/sysfs-bus-usb |
| @@ -59,7 +59,7 @@ recomputed for each resulting segment. See the skbuff.h comment (section 'E') · 58 unmodified lines | ||
| 59 | 59 | for more details. |
| 60 | 60 | |
| 61 | 61 | A driver declares its offload capabilities in netdev->hw_features; see |
| 62 | −Documentation/networking/netdev-features.txt for more. Note that a device | |
| 62 | +Documentation/networking/netdev-features.rst for more. Note that a device | |
| 63 | 63 | which only advertises NETIF_F_IP[V6]_CSUM must still obey the csum_start and |
| 64 | 64 | csum_offset given in the SKB; if it tries to deduce these itself in hardware |
| 65 | 65 | (as some NICs do) the driver should check that the values in the SKB match |
| @@ -0,0 +1,80 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +======================================== | |
| 4 | +The COPS LocalTalk Linux driver (cops.c) | |
| 5 | +======================================== | |
| 6 | + | |
| 7 | +By Jay Schulist <jschlst@samba.org> | |
| 8 | + | |
| 9 | +This driver has two modes and they are: Dayna mode and Tangent mode. | |
| 10 | +Each mode corresponds with the type of card. It has been found | |
| 11 | +that there are 2 main types of cards and all other cards are | |
| 12 | +the same and just have different names or only have minor differences | |
| 13 | +such as more IO ports. As this driver is tested it will | |
| 14 | +become more clear exactly what cards are supported. | |
| 15 | + | |
| 16 | +Right now these cards are known to work with the COPS driver. The | |
| 17 | +LT-200 cards work in a somewhat more limited capacity than the | |
| 18 | +DL200 cards, which work very well and are in use by many people. | |
| 19 | + | |
| 20 | +TANGENT driver mode: | |
| 21 | + - Tangent ATB-II, Novell NL-1000, Daystar Digital LT-200 | |
| 22 | + | |
| 23 | +DAYNA driver mode: | |
| 24 | + - Dayna DL2000/DaynaTalk PC (Half Length), COPS LT-95, | |
| 25 | + - Farallon PhoneNET PC III, Farallon PhoneNET PC II | |
| 26 | + | |
| 27 | +Other cards possibly supported mode unknown though: | |
| 28 | + - Dayna DL2000 (Full length) | |
| 29 | + | |
| 30 | +The COPS driver defaults to using Dayna mode. To change the driver's | |
| 31 | +mode if you built a driver with dual support use board_type=1 or | |
| 32 | +board_type=2 for Dayna or Tangent with insmod. | |
| 33 | + | |
| 34 | +Operation/loading of the driver | |
| 35 | +=============================== | |
| 36 | + | |
| 37 | +Use modprobe like this: /sbin/modprobe cops.o (IO #) (IRQ #) | |
| 38 | +If you do not specify any options the driver will try and use the IO = 0x240, | |
| 39 | +IRQ = 5. As of right now I would only use IRQ 5 for the card, if autoprobing. | |
| 40 | + | |
| 41 | +To load multiple COPS driver Localtalk cards you can do one of the following:: | |
| 42 | + | |
| 43 | + insmod cops io=0x240 irq=5 | |
| 44 | + insmod -o cops2 cops io=0x260 irq=3 | |
| 45 | + | |
| 46 | +Or in lilo.conf put something like this:: | |
| 47 | + | |
| 48 | + append="ether=5,0x240,lt0 ether=3,0x260,lt1" | |
| 49 | + | |
| 50 | +Then bring up the interface with ifconfig. It will look something like this:: | |
| 51 | + | |
| 52 | + lt0 Link encap:UNSPEC HWaddr 00-00-00-00-00-00-00-F7-00-00-00-00-00-00-00-00 | |
| 53 | + inet addr:192.168.1.2 Bcast:192.168.1.255 Mask:255.255.255.0 | |
| 54 | + UP BROADCAST RUNNING NOARP MULTICAST MTU:600 Metric:1 | |
| 55 | + RX packets:0 errors:0 dropped:0 overruns:0 frame:0 | |
| 56 | + TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 coll:0 | |
| 57 | + | |
| 58 | +Netatalk Configuration | |
| 59 | +====================== | |
| 60 | + | |
| 61 | +You will need to configure atalkd with something like the following to make | |
| 62 | +it work with the cops.c driver. | |
| 63 | + | |
| 64 | +* For single LTalk card use:: | |
| 65 | + | |
| 66 | + dummy -seed -phase 2 -net 2000 -addr 2000.10 -zone "1033" | |
| 67 | + lt0 -seed -phase 1 -net 1000 -addr 1000.50 -zone "1033" | |
| 68 | + | |
| 69 | +* For multiple cards, Ethernet and LocalTalk:: | |
| 70 | + | |
| 71 | + eth0 -seed -phase 2 -net 3000 -addr 3000.20 -zone "1033" | |
| 72 | + lt0 -seed -phase 1 -net 1000 -addr 1000.50 -zone "1033" | |
| 73 | + | |
| 74 | +* For multiple LocalTalk cards, and an Ethernet card. | |
| 75 | + | |
| 76 | +* Order seems to matter here, Ethernet last:: | |
| 77 | + | |
| 78 | + lt0 -seed -phase 1 -net 1000 -addr 1000.10 -zone "LocalTalk1" | |
| 79 | + lt1 -seed -phase 1 -net 2000 -addr 2000.20 -zone "LocalTalk2" | |
| 80 | + eth0 -seed -phase 2 -net 3000 -addr 3000.30 -zone "EtherTalk" | |
| @@ -1,63 +0,0 @@ | ||
| 1 | −Text File for the COPS LocalTalk Linux driver (cops.c). | |
| 2 | − By Jay Schulist <jschlst@samba.org> | |
| 3 | − | |
| 4 | −This driver has two modes and they are: Dayna mode and Tangent mode. | |
| 5 | −Each mode corresponds with the type of card. It has been found | |
| 6 | −that there are 2 main types of cards and all other cards are | |
| 7 | −the same and just have different names or only have minor differences | |
| 8 | −such as more IO ports. As this driver is tested it will | |
| 9 | −become more clear exactly what cards are supported. | |
| 10 | − | |
| 11 | −Right now these cards are known to work with the COPS driver. The | |
| 12 | −LT-200 cards work in a somewhat more limited capacity than the | |
| 13 | −DL200 cards, which work very well and are in use by many people. | |
| 14 | − | |
| 15 | −TANGENT driver mode: | |
| 16 | − Tangent ATB-II, Novell NL-1000, Daystar Digital LT-200 | |
| 17 | −DAYNA driver mode: | |
| 18 | − Dayna DL2000/DaynaTalk PC (Half Length), COPS LT-95, | |
| 19 | − Farallon PhoneNET PC III, Farallon PhoneNET PC II | |
| 20 | −Other cards possibly supported mode unknown though: | |
| 21 | − Dayna DL2000 (Full length) | |
| 22 | − | |
| 23 | −The COPS driver defaults to using Dayna mode. To change the driver's | |
| 24 | −mode if you built a driver with dual support use board_type=1 or | |
| 25 | −board_type=2 for Dayna or Tangent with insmod. | |
| 26 | − | |
| 27 | −** Operation/loading of the driver. | |
| 28 | −Use modprobe like this: /sbin/modprobe cops.o (IO #) (IRQ #) | |
| 29 | −If you do not specify any options the driver will try and use the IO = 0x240, | |
| 30 | −IRQ = 5. As of right now I would only use IRQ 5 for the card, if autoprobing. | |
| 31 | − | |
| 32 | −To load multiple COPS driver Localtalk cards you can do one of the following. | |
| 33 | − | |
| 34 | −insmod cops io=0x240 irq=5 | |
| 35 | −insmod -o cops2 cops io=0x260 irq=3 | |
| 36 | − | |
| 37 | −Or in lilo.conf put something like this: | |
| 38 | − append="ether=5,0x240,lt0 ether=3,0x260,lt1" | |
| 39 | − | |
| 40 | −Then bring up the interface with ifconfig. It will look something like this: | |
| 41 | −lt0 Link encap:UNSPEC HWaddr 00-00-00-00-00-00-00-F7-00-00-00-00-00-00-00-00 | |
| 42 | − inet addr:192.168.1.2 Bcast:192.168.1.255 Mask:255.255.255.0 | |
| 43 | − UP BROADCAST RUNNING NOARP MULTICAST MTU:600 Metric:1 | |
| 44 | − RX packets:0 errors:0 dropped:0 overruns:0 frame:0 | |
| 45 | − TX packets:0 errors:0 dropped:0 overruns:0 carrier:0 coll:0 | |
| 46 | − | |
| 47 | −** Netatalk Configuration | |
| 48 | −You will need to configure atalkd with something like the following to make | |
| 49 | −it work with the cops.c driver. | |
| 50 | − | |
| 51 | −* For single LTalk card use. | |
| 52 | −dummy -seed -phase 2 -net 2000 -addr 2000.10 -zone "1033" | |
| 53 | −lt0 -seed -phase 1 -net 1000 -addr 1000.50 -zone "1033" | |
| 54 | − | |
| 55 | −* For multiple cards, Ethernet and LocalTalk. | |
| 56 | −eth0 -seed -phase 2 -net 3000 -addr 3000.20 -zone "1033" | |
| 57 | −lt0 -seed -phase 1 -net 1000 -addr 1000.50 -zone "1033" | |
| 58 | − | |
| 59 | −* For multiple LocalTalk cards, and an Ethernet card. | |
| 60 | −* Order seems to matter here, Ethernet last. | |
| 61 | −lt0 -seed -phase 1 -net 1000 -addr 1000.10 -zone "LocalTalk1" | |
| 62 | −lt1 -seed -phase 1 -net 2000 -addr 2000.20 -zone "LocalTalk2" | |
| 63 | −eth0 -seed -phase 2 -net 3000 -addr 3000.30 -zone "EtherTalk" | |
| @@ -1,3 +1,9 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +======================== | |
| 4 | +ATM cxacru device driver | |
| 5 | +======================== | |
| 6 | + | |
| 1 | 7 | Firmware is required for this device: http://accessrunner.sourceforge.net/ |
| 2 | 8 | |
| 3 | 9 | While it is capable of managing/maintaining the ADSL connection without the |
| @@ -19,29 +25,35 @@ several sysfs attribute files for retrieving device statistics: · 15 unmodified lines | ||
| 19 | 25 | |
| 20 | 26 | * adsl_headend |
| 21 | 27 | * adsl_headend_environment |
| 22 | − Information about the remote headend. | |
| 28 | + | |
| 29 | + - Information about the remote headend. | |
| 23 | 30 | |
| 24 | 31 | * adsl_config |
| 25 | − Configuration writing interface. | |
| 26 | − Write parameters in hexadecimal format <index>=<value>, | |
| 27 | − separated by whitespace, e.g.: | |
| 32 | + | |
| 33 | + - Configuration writing interface. | |
| 34 | + - Write parameters in hexadecimal format <index>=<value>, | |
| 35 | + separated by whitespace, e.g.: | |
| 36 | + | |
| 28 | 37 | "1=0 a=5" |
| 29 | − Up to 7 parameters at a time will be sent and the modem will restart | |
| 30 | − the ADSL connection when any value is set. These are logged for future | |
| 31 | − reference. | |
| 38 | + | |
| 39 | + - Up to 7 parameters at a time will be sent and the modem will restart | |
| 40 | + the ADSL connection when any value is set. These are logged for future | |
| 41 | + reference. | |
| 32 | 42 | |
| 33 | 43 | * downstream_attenuation (dB) |
| 34 | 44 | * downstream_bits_per_frame |
| 35 | 45 | * downstream_rate (kbps) |
| 36 | 46 | * downstream_snr_margin (dB) |
| 37 | − Downstream stats. | |
| 47 | + | |
| 48 | + - Downstream stats. | |
| 38 | 49 | |
| 39 | 50 | * upstream_attenuation (dB) |
| 40 | 51 | * upstream_bits_per_frame |
| 41 | 52 | * upstream_rate (kbps) |
| 42 | 53 | * upstream_snr_margin (dB) |
| 43 | 54 | * transmitter_power (dBm/Hz) |
| 44 | − Upstream stats. | |
| 55 | + | |
| 56 | + - Upstream stats. | |
| 45 | 57 | |
| 46 | 58 | * downstream_crc_errors |
| 47 | 59 | * downstream_fec_errors |
| @@ -49,48 +61,56 @@ several sysfs attribute files for retrieving device statistics: · 1 unmodified line | ||
| 49 | 61 | * upstream_crc_errors |
| 50 | 62 | * upstream_fec_errors |
| 51 | 63 | * upstream_hec_errors |
| 52 | − Error counts. | |
| 64 | + | |
| 65 | + - Error counts. | |
| 53 | 66 | |
| 54 | 67 | * line_startable |
| 55 | − Indicates that ADSL support on the device | |
| 56 | − is/can be enabled, see adsl_start. | |
| 68 | + | |
| 69 | + - Indicates that ADSL support on the device | |
| 70 | + is/can be enabled, see adsl_start. | |
| 57 | 71 | |
| 58 | 72 | * line_status |
| 59 | − "initialising" | |
| 60 | − "down" | |
| 61 | − "attempting to activate" | |
| 62 | − "training" | |
| 63 | − "channel analysis" | |
| 64 | − "exchange" | |
| 65 | − "waiting" | |
| 66 | − "up" | |
| 73 | + | |
| 74 | + - "initialising" | |
| 75 | + - "down" | |
| 76 | + - "attempting to activate" | |
| 77 | + - "training" | |
| 78 | + - "channel analysis" | |
| 79 | + - "exchange" | |
| 80 | + - "waiting" | |
| 81 | + - "up" | |
| 67 | 82 | |
| 68 | 83 | Changes between "down" and "attempting to activate" |
| 69 | 84 | if there is no signal. |
| 70 | 85 | |
| 71 | 86 | * link_status |
| 72 | − "not connected" | |
| 73 | − "connected" | |
| 74 | − "lost" | |
| 87 | + | |
| 88 | + - "not connected" | |
| 89 | + - "connected" | |
| 90 | + - "lost" | |
| 75 | 91 | |
| 76 | 92 | * mac_address |
| 77 | 93 | |
| 78 | 94 | * modulation |
| 79 | − "" (when not connected) | |
| 80 | − "ANSI T1.413" | |
| 81 | − "ITU-T G.992.1 (G.DMT)" | |
| 82 | − "ITU-T G.992.2 (G.LITE)" | |
| 95 | + | |
| 96 | + - "" (when not connected) | |
| 97 | + - "ANSI T1.413" | |
| 98 | + - "ITU-T G.992.1 (G.DMT)" | |
| 99 | + - "ITU-T G.992.2 (G.LITE)" | |
| 83 | 100 | |
| 84 | 101 | * startup_attempts |
| 85 | − Count of total attempts to initialise ADSL. | |
| 102 | + | |
| 103 | + - Count of total attempts to initialise ADSL. | |
| 86 | 104 | |
| 87 | 105 | To enable/disable ADSL, the following can be written to the adsl_state file: |
| 88 | − "start" | |
| 89 | − "stop | |
| 90 | − "restart" (stops, waits 1.5s, then starts) | |
| 91 | − "poll" (used to resume status polling if it was disabled due to failure) | |
| 92 | 106 | |
| 93 | −Changes in adsl/line state are reported via kernel log messages: | |
| 107 | + - "start" | |
| 108 | + - "stop | |
| 109 | + - "restart" (stops, waits 1.5s, then starts) | |
| 110 | + - "poll" (used to resume status polling if it was disabled due to failure) | |
| 111 | + | |
| 112 | +Changes in adsl/line state are reported via kernel log messages:: | |
| 113 | + | |
| 94 | 114 | [4942145.150704] ATM dev 0: ADSL state: running |
| 95 | 115 | [4942243.663766] ATM dev 0: ADSL line: down |
| 96 | 116 | [4942249.665075] ATM dev 0: ADSL line: attempting to activate |
| @@ -1,16 +1,18 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +============= | |
| 1 | 4 | DCCP protocol |
| 2 | 5 | ============= |
| 3 | 6 | |
| 4 | 7 | |
| 5 | −Contents | |
| 6 | −======== | |
| 7 | −- Introduction | |
| 8 | −- Missing features | |
| 9 | −- Socket options | |
| 10 | −- Sysctl variables | |
| 11 | −- IOCTLs | |
| 12 | −- Other tunables | |
| 13 | −- Notes | |
| 8 | +.. Contents | |
| 9 | + - Introduction | |
| 10 | + - Missing features | |
| 11 | + - Socket options | |
| 12 | + - Sysctl variables | |
| 13 | + - IOCTLs | |
| 14 | + - Other tunables | |
| 15 | + - Notes | |
| 14 | 16 | |
| 15 | 17 | |
| 16 | 18 | Introduction |
| @@ -38,6 +40,7 @@ The Linux DCCP implementation does not currently support all the features that a · 21 unmodified lines | ||
| 38 | 40 | specified in RFCs 4340...42. |
| 39 | 41 | |
| 40 | 42 | The known bugs are at: |
| 43 | + | |
| 41 | 44 | http://www.linuxfoundation.org/collaborate/workgroups/networking/todo#DCCP |
| 42 | 45 | |
| 43 | 46 | For more up-to-date versions of the DCCP implementation, please consider using |
| @@ -54,7 +57,8 @@ defined: the "simple" policy (DCCPQ_POLICY_SIMPLE), which does nothing special, · 10 unmodified lines | ||
| 54 | 57 | and a priority-based variant (DCCPQ_POLICY_PRIO). The latter allows to pass an |
| 55 | 58 | u32 priority value as ancillary data to sendmsg(), where higher numbers indicate |
| 56 | 59 | a higher packet priority (similar to SO_PRIORITY). This ancillary data needs to |
| 57 | −be formatted using a cmsg(3) message header filled in as follows: | |
| 60 | +be formatted using a cmsg(3) message header filled in as follows:: | |
| 61 | + | |
| 58 | 62 | cmsg->cmsg_level = SOL_DCCP; |
| 59 | 63 | cmsg->cmsg_type = DCCP_SCM_PRIORITY; |
| 60 | 64 | cmsg->cmsg_len = CMSG_LEN(sizeof(uint32_t)); /* or CMSG_LEN(4) */ |
| @@ -94,7 +98,7 @@ must be registered on the socket before calling connect() or listen(). · 33 unmodified lines | ||
| 94 | 98 | |
| 95 | 99 | DCCP_SOCKOPT_TX_CCID is read/write. It returns the current CCID (if set) or sets |
| 96 | 100 | the preference list for the TX CCID, using the same format as DCCP_SOCKOPT_CCID. |
| 97 | −Please note that the getsockopt argument type here is `int', not uint8_t. | |
| 101 | +Please note that the getsockopt argument type here is ``int``, not uint8_t. | |
| 98 | 102 | |
| 99 | 103 | DCCP_SOCKOPT_RX_CCID is analogous to DCCP_SOCKOPT_TX_CCID, but for the RX CCID. |
| 100 | 104 | |
| @@ -113,6 +117,7 @@ be enabled at the receiver, too with suitable choice of CsCov. · 12 unmodified lines | ||
| 113 | 117 | DCCP_SOCKOPT_SEND_CSCOV sets the sender checksum coverage. Values in the |
| 114 | 118 | range 0..15 are acceptable. The default setting is 0 (full coverage), |
| 115 | 119 | values between 1..15 indicate partial coverage. |
| 120 | + | |
| 116 | 121 | DCCP_SOCKOPT_RECV_CSCOV is for the receiver and has a different meaning: it |
| 117 | 122 | sets a threshold, where again values 0..15 are acceptable. The default |
| 118 | 123 | of 0 means that all packets with a partial coverage will be discarded. |
| @@ -123,11 +128,13 @@ DCCP_SOCKOPT_RECV_CSCOV is for the receiver and has a different meaning: it · 4 unmodified lines | ||
| 123 | 128 | |
| 124 | 129 | The following two options apply to CCID 3 exclusively and are getsockopt()-only. |
| 125 | 130 | In either case, a TFRC info struct (defined in <linux/tfrc.h>) is returned. |
| 131 | + | |
| 126 | 132 | DCCP_SOCKOPT_CCID_RX_INFO |
| 127 | − Returns a `struct tfrc_rx_info' in optval; the buffer for optval and | |
| 133 | + Returns a ``struct tfrc_rx_info`` in optval; the buffer for optval and | |
| 128 | 134 | optlen must be set to at least sizeof(struct tfrc_rx_info). |
| 135 | + | |
| 129 | 136 | DCCP_SOCKOPT_CCID_TX_INFO |
| 130 | − Returns a `struct tfrc_tx_info' in optval; the buffer for optval and | |
| 137 | + Returns a ``struct tfrc_tx_info`` in optval; the buffer for optval and | |
| 131 | 138 | optlen must be set to at least sizeof(struct tfrc_tx_info). |
| 132 | 139 | |
| 133 | 140 | On unidirectional connections it is useful to close the unused half-connection |
| @@ -182,7 +189,7 @@ sync_ratelimit = 125 ms · 48 unmodified lines | ||
| 182 | 189 | IOCTLS |
| 183 | 190 | ====== |
| 184 | 191 | FIONREAD |
| 185 | − Works as in udp(7): returns in the `int' argument pointer the size of | |
| 192 | + Works as in udp(7): returns in the ``int`` argument pointer the size of | |
| 186 | 193 | the next pending datagram in bytes, or 0 when no datagram is pending. |
| 187 | 194 | |
| 188 | 195 | |
| @@ -191,10 +198,12 @@ Other tunables · 2 unmodified lines | ||
| 191 | 198 | Per-route rto_min support |
| 192 | 199 | CCID-2 supports the RTAX_RTO_MIN per-route setting for the minimum value |
| 193 | 200 | of the RTO timer. This setting can be modified via the 'rto_min' option |
| 194 | − of iproute2; for example: | |
| 201 | + of iproute2; for example:: | |
| 202 | + | |
| 195 | 203 | > ip route change 10.0.0.0/24 rto_min 250j dev wlan0 |
| 196 | 204 | > ip route add 10.0.0.254/32 rto_min 800j dev wlan0 |
| 197 | 205 | > ip route show dev wlan0 |
| 206 | + | |
| 198 | 207 | CCID-3 also supports the rto_min setting: it is used to define the lower |
| 199 | 208 | bound for the expiry of the nofeedback timer. This can be useful on LANs |
| 200 | 209 | with very low RTTs (e.g., loopback, Gbit ethernet). |
| @@ -1,11 +1,14 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +====================== | |
| 1 | 4 | DCTCP (DataCenter TCP) |
| 2 | −---------------------- | |
| 5 | +====================== | |
| 3 | 6 | |
| 4 | 7 | DCTCP is an enhancement to the TCP congestion control algorithm for data |
| 5 | 8 | center networks and leverages Explicit Congestion Notification (ECN) in |
| 6 | 9 | the data center network to provide multi-bit feedback to the end hosts. |
| 7 | 10 | |
| 8 | −To enable it on end hosts: | |
| 11 | +To enable it on end hosts:: | |
| 9 | 12 | |
| 10 | 13 | sysctl -w net.ipv4.tcp_congestion_control=dctcp |
| 11 | 14 | sysctl -w net.ipv4.tcp_ecn_fallback=0 (optional) |
| @@ -25,14 +28,19 @@ SIGCOMM/SIGMETRICS papers: · 13 unmodified lines | ||
| 25 | 28 | |
| 26 | 29 | i) Mohammad Alizadeh, Albert Greenberg, David A. Maltz, Jitendra Padhye, |
| 27 | 30 | Parveen Patel, Balaji Prabhakar, Sudipta Sengupta, and Murari Sridharan: |
| 28 | − "Data Center TCP (DCTCP)", Data Center Networks session | |
| 31 | + | |
| 32 | + "Data Center TCP (DCTCP)", Data Center Networks session" | |
| 33 | + | |
| 29 | 34 | Proc. ACM SIGCOMM, New Delhi, 2010. |
| 35 | + | |
| 30 | 36 | http://simula.stanford.edu/~alizade/Site/DCTCP_files/dctcp-final.pdf |
| 31 | 37 | http://www.sigcomm.org/ccr/papers/2010/October/1851275.1851192 |
| 32 | 38 | |
| 33 | 39 | ii) Mohammad Alizadeh, Adel Javanmard, and Balaji Prabhakar: |
| 40 | + | |
| 34 | 41 | "Analysis of DCTCP: Stability, Convergence, and Fairness" |
| 35 | 42 | Proc. ACM SIGMETRICS, San Jose, 2011. |
| 43 | + | |
| 36 | 44 | http://simula.stanford.edu/~alizade/Site/DCTCP_files/dctcp_analysis-full.pdf |
| 37 | 45 | |
| 38 | 46 | IETF informational draft: |
| @@ -1,26 +1,31 @@ | ||
| 1 | − Linux DECnet Networking Layer Information | |
| 2 | − =========================================== | |
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 3 | 2 | |
| 4 | −1) Other documentation.... | |
| 3 | +========================================= | |
| 4 | +Linux DECnet Networking Layer Information | |
| 5 | +========================================= | |
| 5 | 6 | |
| 6 | − o Project Home Pages | |
| 7 | − http://www.chygwyn.com/ - Kernel info | |
| 8 | − http://linux-decnet.sourceforge.net/ - Userland tools | |
| 9 | − http://www.sourceforge.net/projects/linux-decnet/ - Status page | |
| 7 | +1. Other documentation.... | |
| 8 | +========================== | |
| 10 | 9 | |
| 11 | −2) Configuring the kernel | |
| 10 | + - Project Home Pages | |
| 11 | + - http://www.chygwyn.com/ - Kernel info | |
| 12 | + - http://linux-decnet.sourceforge.net/ - Userland tools | |
| 13 | + - http://www.sourceforge.net/projects/linux-decnet/ - Status page | |
| 14 | + | |
| 15 | +2. Configuring the kernel | |
| 16 | +========================= | |
| 12 | 17 | |
| 13 | 18 | Be sure to turn on the following options: |
| 14 | 19 | |
| 15 | − CONFIG_DECNET (obviously) | |
| 16 | − CONFIG_PROC_FS (to see what's going on) | |
| 17 | − CONFIG_SYSCTL (for easy configuration) | |
| 20 | + - CONFIG_DECNET (obviously) | |
| 21 | + - CONFIG_PROC_FS (to see what's going on) | |
| 22 | + - CONFIG_SYSCTL (for easy configuration) | |
| 18 | 23 | |
| 19 | 24 | if you want to try out router support (not properly debugged yet) |
| 20 | 25 | you'll need the following options as well... |
| 21 | 26 | |
| 22 | − CONFIG_DECNET_ROUTER (to be able to add/delete routes) | |
| 23 | − CONFIG_NETFILTER (will be required for the DECnet routing daemon) | |
| 27 | + - CONFIG_DECNET_ROUTER (to be able to add/delete routes) | |
| 28 | + - CONFIG_NETFILTER (will be required for the DECnet routing daemon) | |
| 24 | 29 | |
| 25 | 30 | Don't turn on SIOCGIFCONF support for DECnet unless you are really sure |
| 26 | 31 | that you need it, in general you won't and it can cause ifconfig to |
| @@ -29,7 +34,7 @@ malfunction. · 2 unmodified lines | ||
| 29 | 34 | Run time configuration has changed slightly from the 2.4 system. If you |
| 30 | 35 | want to configure an endnode, then the simplified procedure is as follows: |
| 31 | 36 | |
| 32 | − o Set the MAC address on your ethernet card before starting _any_ other | |
| 37 | + - Set the MAC address on your ethernet card before starting _any_ other | |
| 33 | 38 | network protocols. |
| 34 | 39 | |
| 35 | 40 | As soon as your network card is brought into the UP state, DECnet should |
| @@ -37,7 +42,8 @@ start working. If you need something more complicated or are unsure how · 1 unmodified line | ||
| 37 | 42 | to set the MAC address, see the next section. Also all configurations which |
| 38 | 43 | worked with 2.4 will work under 2.5 with no change. |
| 39 | 44 | |
| 40 | −3) Command line options | |
| 45 | +3. Command line options | |
| 46 | +======================= | |
| 41 | 47 | |
| 42 | 48 | You can set a DECnet address on the kernel command line for compatibility |
| 43 | 49 | with the 2.4 configuration procedure, but in general it's not needed any more. |
| @@ -56,7 +62,7 @@ interface then you won't see any entries in /proc/net/neigh for the local · 12 unmodified lines | ||
| 56 | 62 | host until such time as you start a connection. This doesn't affect the |
| 57 | 63 | operation of the local communications in any other way though. |
| 58 | 64 | |
| 59 | −The kernel command line takes options looking like the following: | |
| 65 | +The kernel command line takes options looking like the following:: | |
| 60 | 66 | |
| 61 | 67 | decnet.addr=1,2 |
| 62 | 68 | |
| @@ -82,7 +88,7 @@ address of the node in order for it to be autoconfigured (and then appear in · 19 unmodified lines | ||
| 82 | 88 | FTP sites called dn2ethaddr which can compute the correct ethernet |
| 83 | 89 | address to use. The address can be set by ifconfig either before or |
| 84 | 90 | at the time the device is brought up. If you are using RedHat you can |
| 85 | −add the line: | |
| 91 | +add the line:: | |
| 86 | 92 | |
| 87 | 93 | MACADDR=AA:00:04:00:03:04 |
| 88 | 94 | |
| @@ -95,7 +101,7 @@ verify with iproute2). · 6 unmodified lines | ||
| 95 | 101 | The default device for routing can be set through the /proc filesystem |
| 96 | 102 | by setting /proc/sys/net/decnet/default_device to the |
| 97 | 103 | device you want DECnet to route packets out of when no specific route |
| 98 | −is available. Usually this will be eth0, for example: | |
| 104 | +is available. Usually this will be eth0, for example:: | |
| 99 | 105 | |
| 100 | 106 | echo -n "eth0" >/proc/sys/net/decnet/default_device |
| 101 | 107 | |
| @@ -106,7 +112,9 @@ confirm that by looking in the default_device file of course. · 4 unmodified lines | ||
| 106 | 112 | There is a list of what the other files under /proc/sys/net/decnet/ do |
| 107 | 113 | on the kernel patch web site (shown above). |
| 108 | 114 | |
| 109 | −4) Run time kernel configuration | |
| 115 | +4. Run time kernel configuration | |
| 116 | +================================ | |
| 117 | + | |
| 110 | 118 | |
| 111 | 119 | This is either done through the sysctl/proc interface (see the kernel web |
| 112 | 120 | pages for details on what the various options do) or through the iproute2 |
| @@ -122,20 +130,21 @@ since its the _only_ way to add and delete routes currently. Eventually · 9 unmodified lines | ||
| 122 | 130 | there will be a routing daemon to send and receive routing messages for |
| 123 | 131 | each interface and update the kernel routing tables accordingly. The |
| 124 | 132 | routing daemon will use netfilter to listen to routing packets, and |
| 125 | −rtnetlink to update the kernels routing tables. | |
| 133 | +rtnetlink to update the kernels routing tables. | |
| 126 | 134 | |
| 127 | 135 | The DECnet raw socket layer has been removed since it was there purely |
| 128 | 136 | for use by the routing daemon which will now use netfilter (a much cleaner |
| 129 | 137 | and more generic solution) instead. |
| 130 | 138 | |
| 131 | −5) How can I tell if its working ? | |
| 139 | +5. How can I tell if its working? | |
| 140 | +================================= | |
| 132 | 141 | |
| 133 | 142 | Here is a quick guide of what to look for in order to know if your DECnet |
| 134 | 143 | kernel subsystem is working. |
| 135 | 144 | |
| 136 | 145 | - Is the node address set (see /proc/sys/net/decnet/node_address) |
| 137 | − - Is the node of the correct type | |
| 138 | − (see /proc/sys/net/decnet/conf/<dev>/forwarding) | |
| 146 | + - Is the node of the correct type | |
| 147 | + (see /proc/sys/net/decnet/conf/<dev>/forwarding) | |
| 139 | 148 | - Is the Ethernet MAC address of each Ethernet card set to match |
| 140 | 149 | the DECnet address. If in doubt use the dn2ethaddr utility available |
| 141 | 150 | at the ftp archive. |
| @@ -160,7 +169,8 @@ kernel subsystem is working. · 18 unmodified lines | ||
| 160 | 169 | network, and see if you can obtain the same results. |
| 161 | 170 | - At this point you are on your own... :-) |
| 162 | 171 | |
| 163 | −6) How to send a bug report | |
| 172 | +6. How to send a bug report | |
| 173 | +=========================== | |
| 164 | 174 | |
| 165 | 175 | If you've found a bug and want to report it, then there are several things |
| 166 | 176 | you can do to help me work out exactly what it is that is wrong. Useful |
| @@ -175,18 +185,19 @@ information (_most_ of which _is_ _essential_) includes: · 8 unmodified lines | ||
| 175 | 185 | - How much data was being transferred ? |
| 176 | 186 | - Was the network congested ? |
| 177 | 187 | - How can the problem be reproduced ? |
| 178 | − - Can you use tcpdump to get a trace ? (N.B. Most (all?) versions of | |
| 188 | + - Can you use tcpdump to get a trace ? (N.B. Most (all?) versions of | |
| 179 | 189 | tcpdump don't understand how to dump DECnet properly, so including |
| 180 | 190 | the hex listing of the packet contents is _essential_, usually the -x flag. |
| 181 | 191 | You may also need to increase the length grabbed with the -s flag. The |
| 182 | 192 | -e flag also provides very useful information (ethernet MAC addresses)) |
| 183 | 193 | |
| 184 | −7) MAC FAQ | |
| 194 | +7. MAC FAQ | |
| 195 | +========== | |
| 185 | 196 | |
| 186 | 197 | A quick FAQ on ethernet MAC addresses to explain how Linux and DECnet |
| 187 | −interact and how to get the best performance from your hardware. | |
| 198 | +interact and how to get the best performance from your hardware. | |
| 188 | 199 | |
| 189 | −Ethernet cards are designed to normally only pass received network frames | |
| 200 | +Ethernet cards are designed to normally only pass received network frames | |
| 190 | 201 | to a host computer when they are addressed to it, or to the broadcast address. |
| 191 | 202 | |
| 192 | 203 | Linux has an interface which allows the setting of extra addresses for |
| @@ -197,8 +208,8 @@ significant processor time and bus bandwidth can be used up on a busy · 4 unmodified lines | ||
| 197 | 208 | network (see the NAPI documentation for a longer explanation of these |
| 198 | 209 | effects). |
| 199 | 210 | |
| 200 | −DECnet makes use of this interface to allow running DECnet on an ethernet | |
| 201 | −card which has already been configured using TCP/IP (presumably using the | |
| 211 | +DECnet makes use of this interface to allow running DECnet on an ethernet | |
| 212 | +card which has already been configured using TCP/IP (presumably using the | |
| 202 | 213 | built in MAC address of the card, as usual) and/or to allow multiple DECnet |
| 203 | 214 | addresses on each physical interface. If you do this, be aware that if your |
| 204 | 215 | ethernet card doesn't support perfect hashing in its MAC address filter |
| @@ -210,7 +221,8 @@ to gain the best efficiency. Better still is to use a card which supports · 5 unmodified lines | ||
| 210 | 221 | NAPI as well. |
| 211 | 222 | |
| 212 | 223 | |
| 213 | −8) Mailing list | |
| 224 | +8. Mailing list | |
| 225 | +=============== | |
| 214 | 226 | |
| 215 | 227 | If you are keen to get involved in development, or want to ask questions |
| 216 | 228 | about configuration, or even just report bugs, then there is a mailing |
| @@ -218,7 +230,8 @@ list that you can join, details are at: · 1 unmodified line | ||
| 218 | 230 | |
| 219 | 231 | http://sourceforge.net/mail/?group_id=4993 |
| 220 | 232 | |
| 221 | −9) Legal Info | |
| 233 | +9. Legal Info | |
| 234 | +============= | |
| 222 | 235 | |
| 223 | 236 | The Linux DECnet project team have placed their code under the GPL. The |
| 224 | 237 | software is provided "as is" and without warranty express or implied. |
| @@ -1,4 +1,10 @@ | ||
| 1 | −Notes on the DEC FDDIcontroller 700 (DEFZA-xx) driver v.1.1.4. | |
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +===================================================== | |
| 4 | +Notes on the DEC FDDIcontroller 700 (DEFZA-xx) driver | |
| 5 | +===================================================== | |
| 6 | + | |
| 7 | +:Version: v.1.1.4 | |
| 2 | 8 | |
| 3 | 9 | |
| 4 | 10 | DEC FDDIcontroller 700 is DEC's first-generation TURBOchannel FDDI |
| @@ -1,17 +1,21 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +============================================================================= | |
| 1 | 4 | Linux and the 3Com EtherLink III Series Ethercards (driver v1.18c and higher) |
| 2 | −---------------------------------------------------------------------------- | |
| 5 | +============================================================================= | |
| 3 | 6 | |
| 4 | 7 | This file contains the instructions and caveats for v1.18c and higher versions |
| 5 | 8 | of the 3c509 driver. You should not use the driver without reading this file. |
| 6 | 9 | |
| 7 | 10 | release 1.0 |
| 11 | + | |
| 8 | 12 | 28 February 2002 |
| 13 | + | |
| 9 | 14 | Current maintainer (corrections to): |
| 10 | 15 | David Ruggiero <jdr@farfalle.com> |
| 11 | 16 | |
| 12 | −---------------------------------------------------------------------------- | |
| 13 | − | |
| 14 | −(0) Introduction | |
| 17 | +Introduction | |
| 18 | +============ | |
| 15 | 19 | |
| 16 | 20 | The following are notes and information on using the 3Com EtherLink III series |
| 17 | 21 | ethercards in Linux. These cards are commonly known by the most widely-used |
| @@ -21,11 +25,11 @@ be (but sometimes are) confused with the similarly-numbered PCI-bus "3c905" · 3 unmodified lines | ||
| 21 | 25 | provided by the module 3c509.c, which has code to support all of the following |
| 22 | 26 | models: |
| 23 | 27 | |
| 24 | − 3c509 (original ISA card) | |
| 25 | − 3c509B (later revision of the ISA card; supports full-duplex) | |
| 26 | − 3c589 (PCMCIA) | |
| 27 | − 3c589B (later revision of the 3c589; supports full-duplex) | |
| 28 | − 3c579 (EISA) | |
| 28 | + - 3c509 (original ISA card) | |
| 29 | + - 3c509B (later revision of the ISA card; supports full-duplex) | |
| 30 | + - 3c589 (PCMCIA) | |
| 31 | + - 3c589B (later revision of the 3c589; supports full-duplex) | |
| 32 | + - 3c579 (EISA) | |
| 29 | 33 | |
| 30 | 34 | Large portions of this documentation were heavily borrowed from the guide |
| 31 | 35 | written the original author of the 3c509 driver, Donald Becker. The master |
| @@ -33,32 +37,34 @@ copy of that document, which contains notes on older versions of the driver, · 1 unmodified line | ||
| 33 | 37 | currently resides on Scyld web server: http://www.scyld.com/. |
| 34 | 38 | |
| 35 | 39 | |
| 36 | −(1) Special Driver Features | |
| 40 | +Special Driver Features | |
| 41 | +======================= | |
| 37 | 42 | |
| 38 | 43 | Overriding card settings |
| 39 | 44 | |
| 40 | 45 | The driver allows boot- or load-time overriding of the card's detected IOADDR, |
| 41 | 46 | IRQ, and transceiver settings, although this capability shouldn't generally be |
| 42 | 47 | needed except to enable full-duplex mode (see below). An example of the syntax |
| 43 | −for LILO parameters for doing this: | |
| 48 | +for LILO parameters for doing this:: | |
| 44 | 49 | |
| 45 | − ether=10,0x310,3,0x3c509,eth0 | |
| 50 | + ether=10,0x310,3,0x3c509,eth0 | |
| 46 | 51 | |
| 47 | 52 | This configures the first found 3c509 card for IRQ 10, base I/O 0x310, and |
| 48 | 53 | transceiver type 3 (10base2). The flag "0x3c509" must be set to avoid conflicts |
| 49 | 54 | with other card types when overriding the I/O address. When the driver is |
| 50 | 55 | loaded as a module, only the IRQ may be overridden. For example, |
| 51 | 56 | setting two cards to IRQ10 and IRQ11 is done by using the irq module |
| 52 | −option: | |
| 57 | +option:: | |
| 53 | 58 | |
| 54 | 59 | options 3c509 irq=10,11 |
| 55 | 60 | |
| 56 | 61 | |
| 57 | −(2) Full-duplex mode | |
| 62 | +Full-duplex mode | |
| 63 | +================ | |
| 58 | 64 | |
| 59 | 65 | The v1.18c driver added support for the 3c509B's full-duplex capabilities. |
| 60 | 66 | In order to enable and successfully use full-duplex mode, three conditions |
| 61 | −must be met: | |
| 67 | +must be met: | |
| 62 | 68 | |
| 63 | 69 | (a) You must have a Etherlink III card model whose hardware supports full- |
| 64 | 70 | duplex operations. Currently, the only members of the 3c509 family that are |
| @@ -78,27 +84,32 @@ duplex-capable Ethernet switch (*not* a hub), or a full-duplex-capable NIC on · 13 unmodified lines | ||
| 78 | 84 | another system that's connected directly to the 3c509B via a crossover cable. |
| 79 | 85 | |
| 80 | 86 | Full-duplex mode can be enabled using 'ethtool'. |
| 81 | − | |
| 82 | −/////Extremely important caution concerning full-duplex mode///// | |
| 83 | −Understand that the 3c509B's hardware's full-duplex support is much more | |
| 84 | −limited than that provide by more modern network interface cards. Although | |
| 85 | −at the physical layer of the network it fully supports full-duplex operation, | |
| 86 | −the card was designed before the current Ethernet auto-negotiation (N-way) | |
| 87 | −spec was written. This means that the 3c509B family ***cannot and will not | |
| 88 | −auto-negotiate a full-duplex connection with its link partner under any | |
| 89 | −circumstances, no matter how it is initialized***. If the full-duplex mode | |
| 90 | −of the 3c509B is enabled, its link partner will very likely need to be | |
| 91 | −independently _forced_ into full-duplex mode as well; otherwise various nasty | |
| 92 | −failures will occur - at the very least, you'll see massive numbers of packet | |
| 93 | −collisions. This is one of very rare circumstances where disabling auto- | |
| 94 | −negotiation and forcing the duplex mode of a network interface card or switch | |
| 95 | −would ever be necessary or desirable. | |
| 96 | − | |
| 97 | − | |
| 98 | −(3) Available Transceiver Types | |
| 87 | + | |
| 88 | +.. warning:: | |
| 89 | + | |
| 90 | + Extremely important caution concerning full-duplex mode | |
| 91 | + | |
| 92 | + Understand that the 3c509B's hardware's full-duplex support is much more | |
| 93 | + limited than that provide by more modern network interface cards. Although | |
| 94 | + at the physical layer of the network it fully supports full-duplex operation, | |
| 95 | + the card was designed before the current Ethernet auto-negotiation (N-way) | |
| 96 | + spec was written. This means that the 3c509B family ***cannot and will not | |
| 97 | + auto-negotiate a full-duplex connection with its link partner under any | |
| 98 | + circumstances, no matter how it is initialized***. If the full-duplex mode | |
| 99 | + of the 3c509B is enabled, its link partner will very likely need to be | |
| 100 | + independently _forced_ into full-duplex mode as well; otherwise various nasty | |
| 101 | + failures will occur - at the very least, you'll see massive numbers of packet | |
| 102 | + collisions. This is one of very rare circumstances where disabling auto- | |
| 103 | + negotiation and forcing the duplex mode of a network interface card or switch | |
| 104 | + would ever be necessary or desirable. | |
| 105 | + | |
| 106 | + | |
| 107 | +Available Transceiver Types | |
| 108 | +=========================== | |
| 99 | 109 | |
| 100 | 110 | For versions of the driver v1.18c and above, the available transceiver types are: |
| 101 | − | |
| 111 | + | |
| 112 | +== ========================================================================= | |
| 102 | 113 | 0 transceiver type from EEPROM config (normally 10baseT); force half-duplex |
| 103 | 114 | 1 AUI (thick-net / DB15 connector) |
| 104 | 115 | 2 (undefined) |
| @@ -106,6 +117,7 @@ For versions of the driver v1.18c and above, the available transceiver types are · 1 unmodified line | ||
| 106 | 117 | 4 10baseT (RJ-45 connector); force half-duplex mode |
| 107 | 118 | 8 transceiver type and duplex mode taken from card's EEPROM config settings |
| 108 | 119 | 12 10baseT (RJ-45 connector); force full-duplex mode |
| 120 | +== ========================================================================= | |
| 109 | 121 | |
| 110 | 122 | Prior to driver version 1.18c, only transceiver codes 0-4 were supported. Note |
| 111 | 123 | that the new transceiver codes 8 and 12 are the *only* ones that will enable |
| @@ -116,26 +128,30 @@ it must always be explicitly enabled via one of these code in order to be · 4 unmodified lines | ||
| 116 | 128 | activated. |
| 117 | 129 | |
| 118 | 130 | The transceiver type can be changed using 'ethtool'. |
| 119 | − | |
| 120 | 131 | |
| 121 | −(4a) Interpretation of error messages and common problems | |
| 132 | + | |
| 133 | +Interpretation of error messages and common problems | |
| 134 | +---------------------------------------------------- | |
| 122 | 135 | |
| 123 | 136 | Error Messages |
| 137 | +^^^^^^^^^^^^^^ | |
| 124 | 138 | |
| 125 | −eth0: Infinite loop in interrupt, status 2011. | |
| 139 | +eth0: Infinite loop in interrupt, status 2011. | |
| 126 | 140 | These are "mostly harmless" message indicating that the driver had too much |
| 127 | 141 | work during that interrupt cycle. With a status of 0x2011 you are receiving |
| 128 | 142 | packets faster than they can be removed from the card. This should be rare |
| 129 | 143 | or impossible in normal operation. Possible causes of this error report are: |
| 130 | − | |
| 144 | + | |
| 131 | 145 | - a "green" mode enabled that slows the processor down when there is no |
| 132 | − keyboard activity. | |
| 146 | + keyboard activity. | |
| 133 | 147 | |
| 134 | 148 | - some other device or device driver hogging the bus or disabling interrupts. |
| 135 | 149 | Check /proc/interrupts for excessive interrupt counts. The timer tick |
| 136 | − interrupt should always be incrementing faster than the others. | |
| 150 | + interrupt should always be incrementing faster than the others. | |
| 151 | + | |
| 152 | +No received packets | |
| 153 | +^^^^^^^^^^^^^^^^^^^ | |
| 137 | 154 | |
| 138 | −No received packets | |
| 139 | 155 | If a 3c509, 3c562 or 3c589 can successfully transmit packets, but never |
| 140 | 156 | receives packets (as reported by /proc/net/dev or 'ifconfig') you likely |
| 141 | 157 | have an interrupt line problem. Check /proc/interrupts to verify that the |
| @@ -146,26 +162,37 @@ or IRQ5, and the easiest solution is to move the 3c509 to a different · 4 unmodified lines | ||
| 146 | 162 | interrupt line. If the device is receiving packets but 'ping' doesn't work, |
| 147 | 163 | you have a routing problem. |
| 148 | 164 | |
| 149 | −Tx Carrier Errors Reported in /proc/net/dev | |
| 165 | +Tx Carrier Errors Reported in /proc/net/dev | |
| 166 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 167 | + | |
| 168 | + | |
| 150 | 169 | If an EtherLink III appears to transmit packets, but the "Tx carrier errors" |
| 151 | 170 | field in /proc/net/dev increments as quickly as the Tx packet count, you |
| 152 | −likely have an unterminated network or the incorrect media transceiver selected. | |
| 171 | +likely have an unterminated network or the incorrect media transceiver selected. | |
| 172 | + | |
| 173 | +3c509B card is not detected on machines with an ISA PnP BIOS. | |
| 174 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 153 | 175 | |
| 154 | −3c509B card is not detected on machines with an ISA PnP BIOS. | |
| 155 | 176 | While the updated driver works with most PnP BIOS programs, it does not work |
| 156 | 177 | with all. This can be fixed by disabling PnP support using the 3Com-supplied |
| 157 | −setup program. | |
| 178 | +setup program. | |
| 179 | + | |
| 180 | +3c509 card is not detected on overclocked machines | |
| 181 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 158 | 182 | |
| 159 | −3c509 card is not detected on overclocked machines | |
| 160 | 183 | Increase the delay time in id_read_eeprom() from the current value, 500, |
| 161 | −to an absurdly high value, such as 5000. | |
| 184 | +to an absurdly high value, such as 5000. | |
| 185 | + | |
| 162 | 186 | |
| 187 | +Decoding Status and Error Messages | |
| 188 | +---------------------------------- | |
| 163 | 189 | |
| 164 | −(4b) Decoding Status and Error Messages | |
| 165 | 190 | |
| 166 | −The bits in the main status register are: | |
| 191 | +The bits in the main status register are: | |
| 167 | 192 | |
| 193 | +===== ====================================== | |
| 168 | 194 | value description |
| 195 | +===== ====================================== | |
| 169 | 196 | 0x01 Interrupt latch |
| 170 | 197 | 0x02 Tx overrun, or Rx underrun |
| 171 | 198 | 0x04 Tx complete |
| @@ -174,30 +201,38 @@ value description · 2 unmodified lines | ||
| 174 | 201 | 0x20 A Rx packet has started to arrive |
| 175 | 202 | 0x40 The driver has requested an interrupt |
| 176 | 203 | 0x80 Statistics counter nearly full |
| 204 | +===== ====================================== | |
| 177 | 205 | |
| 178 | −The bits in the transmit (Tx) status word are: | |
| 206 | +The bits in the transmit (Tx) status word are: | |
| 179 | 207 | |
| 180 | −value description | |
| 181 | −0x02 Out-of-window collision. | |
| 182 | −0x04 Status stack overflow (normally impossible). | |
| 183 | −0x08 16 collisions. | |
| 184 | −0x10 Tx underrun (not enough PCI bus bandwidth). | |
| 185 | −0x20 Tx jabber. | |
| 186 | −0x40 Tx interrupt requested. | |
| 187 | −0x80 Status is valid (this should always be set). | |
| 208 | +===== ============================================ | |
| 209 | +value description | |
| 210 | +===== ============================================ | |
| 211 | +0x02 Out-of-window collision. | |
| 212 | +0x04 Status stack overflow (normally impossible). | |
| 213 | +0x08 16 collisions. | |
| 214 | +0x10 Tx underrun (not enough PCI bus bandwidth). | |
| 215 | +0x20 Tx jabber. | |
| 216 | +0x40 Tx interrupt requested. | |
| 217 | +0x80 Status is valid (this should always be set). | |
| 218 | +===== ============================================ | |
| 188 | 219 | |
| 189 | 220 | |
| 190 | −When a transmit error occurs the driver produces a status message such as | |
| 221 | +When a transmit error occurs the driver produces a status message such as:: | |
| 191 | 222 | |
| 192 | 223 | eth0: Transmit error, Tx status register 82 |
| 193 | 224 | |
| 194 | 225 | The two values typically seen here are: |
| 195 | 226 | |
| 196 | −0x82 | |
| 227 | +0x82 | |
| 228 | +^^^^ | |
| 229 | + | |
| 197 | 230 | Out of window collision. This typically occurs when some other Ethernet |
| 198 | −host is incorrectly set to full duplex on a half duplex network. | |
| 231 | +host is incorrectly set to full duplex on a half duplex network. | |
| 232 | + | |
| 233 | +0x88 | |
| 234 | +^^^^ | |
| 199 | 235 | |
| 200 | −0x88 | |
| 201 | 236 | 16 collisions. This typically occurs when the network is exceptionally busy |
| 202 | 237 | or when another host doesn't correctly back off after a collision. If this |
| 203 | 238 | error is mixed with 0x82 errors it is the result of a host incorrectly set |
| @@ -207,7 +242,8 @@ Both of these errors are the result of network problems that should be · 3 unmodified lines | ||
| 207 | 242 | corrected. They do not represent driver malfunction. |
| 208 | 243 | |
| 209 | 244 | |
| 210 | −(5) Revision history (this file) | |
| 245 | +Revision history (this file) | |
| 246 | +============================ | |
| 211 | 247 | |
| 212 | 248 | 28Feb02 v1.0 DR New; major portions based on Becker original 3c509 docs |
| 213 | 249 | |
| @@ -1,5 +1,13 @@ | ||
| 1 | −Documentation/networking/device_drivers/3com/vortex.txt | |
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +========================= | |
| 4 | +3Com Vortex device driver | |
| 5 | +========================= | |
| 6 | + | |
| 7 | +Documentation/networking/device_drivers/3com/vortex.rst | |
| 8 | + | |
| 2 | 9 | Andrew Morton |
| 10 | + | |
| 3 | 11 | 30 April 2000 |
| 4 | 12 | |
| 5 | 13 | |
| @@ -8,12 +16,12 @@ driver for Linux, 3c59x.c. · 2 unmodified lines | ||
| 8 | 16 | |
| 9 | 17 | The driver was written by Donald Becker <becker@scyld.com> |
| 10 | 18 | |
| 11 | −Don is no longer the prime maintainer of this version of the driver. | |
| 19 | +Don is no longer the prime maintainer of this version of the driver. | |
| 12 | 20 | Please report problems to one or more of: |
| 13 | 21 | |
| 14 | − Andrew Morton | |
| 15 | − Netdev mailing list <netdev@vger.kernel.org> | |
| 16 | − Linux kernel mailing list <linux-kernel@vger.kernel.org> | |
| 22 | +- Andrew Morton | |
| 23 | +- Netdev mailing list <netdev@vger.kernel.org> | |
| 24 | +- Linux kernel mailing list <linux-kernel@vger.kernel.org> | |
| 17 | 25 | |
| 18 | 26 | Please note the 'Reporting and Diagnosing Problems' section at the end |
| 19 | 27 | of this file. |
| @@ -24,58 +32,58 @@ Since kernel 2.3.99-pre6, this driver incorporates the support for the · 4 unmodified lines | ||
| 24 | 32 | |
| 25 | 33 | This driver supports the following hardware: |
| 26 | 34 | |
| 27 | − 3c590 Vortex 10Mbps | |
| 28 | − 3c592 EISA 10Mbps Demon/Vortex | |
| 29 | − 3c597 EISA Fast Demon/Vortex | |
| 30 | − 3c595 Vortex 100baseTx | |
| 31 | − 3c595 Vortex 100baseT4 | |
| 32 | − 3c595 Vortex 100base-MII | |
| 33 | − 3c900 Boomerang 10baseT | |
| 34 | − 3c900 Boomerang 10Mbps Combo | |
| 35 | − 3c900 Cyclone 10Mbps TPO | |
| 36 | − 3c900 Cyclone 10Mbps Combo | |
| 37 | − 3c900 Cyclone 10Mbps TPC | |
| 38 | − 3c900B-FL Cyclone 10base-FL | |
| 39 | − 3c905 Boomerang 100baseTx | |
| 40 | − 3c905 Boomerang 100baseT4 | |
| 41 | − 3c905B Cyclone 100baseTx | |
| 42 | − 3c905B Cyclone 10/100/BNC | |
| 43 | − 3c905B-FX Cyclone 100baseFx | |
| 44 | − 3c905C Tornado | |
| 45 | − 3c920B-EMB-WNM (ATI Radeon 9100 IGP) | |
| 46 | − 3c980 Cyclone | |
| 47 | − 3c980C Python-T | |
| 48 | − 3cSOHO100-TX Hurricane | |
| 49 | − 3c555 Laptop Hurricane | |
| 50 | − 3c556 Laptop Tornado | |
| 51 | − 3c556B Laptop Hurricane | |
| 52 | − 3c575 [Megahertz] 10/100 LAN CardBus | |
| 53 | − 3c575 Boomerang CardBus | |
| 54 | − 3CCFE575BT Cyclone CardBus | |
| 55 | − 3CCFE575CT Tornado CardBus | |
| 56 | − 3CCFE656 Cyclone CardBus | |
| 57 | − 3CCFEM656B Cyclone+Winmodem CardBus | |
| 58 | − 3CXFEM656C Tornado+Winmodem CardBus | |
| 59 | − 3c450 HomePNA Tornado | |
| 60 | − 3c920 Tornado | |
| 61 | − 3c982 Hydra Dual Port A | |
| 62 | − 3c982 Hydra Dual Port B | |
| 63 | − 3c905B-T4 | |
| 64 | − 3c920B-EMB-WNM Tornado | |
| 35 | + - 3c590 Vortex 10Mbps | |
| 36 | + - 3c592 EISA 10Mbps Demon/Vortex | |
| 37 | + - 3c597 EISA Fast Demon/Vortex | |
| 38 | + - 3c595 Vortex 100baseTx | |
| 39 | + - 3c595 Vortex 100baseT4 | |
| 40 | + - 3c595 Vortex 100base-MII | |
| 41 | + - 3c900 Boomerang 10baseT | |
| 42 | + - 3c900 Boomerang 10Mbps Combo | |
| 43 | + - 3c900 Cyclone 10Mbps TPO | |
| 44 | + - 3c900 Cyclone 10Mbps Combo | |
| 45 | + - 3c900 Cyclone 10Mbps TPC | |
| 46 | + - 3c900B-FL Cyclone 10base-FL | |
| 47 | + - 3c905 Boomerang 100baseTx | |
| 48 | + - 3c905 Boomerang 100baseT4 | |
| 49 | + - 3c905B Cyclone 100baseTx | |
| 50 | + - 3c905B Cyclone 10/100/BNC | |
| 51 | + - 3c905B-FX Cyclone 100baseFx | |
| 52 | + - 3c905C Tornado | |
| 53 | + - 3c920B-EMB-WNM (ATI Radeon 9100 IGP) | |
| 54 | + - 3c980 Cyclone | |
| 55 | + - 3c980C Python-T | |
| 56 | + - 3cSOHO100-TX Hurricane | |
| 57 | + - 3c555 Laptop Hurricane | |
| 58 | + - 3c556 Laptop Tornado | |
| 59 | + - 3c556B Laptop Hurricane | |
| 60 | + - 3c575 [Megahertz] 10/100 LAN CardBus | |
| 61 | + - 3c575 Boomerang CardBus | |
| 62 | + - 3CCFE575BT Cyclone CardBus | |
| 63 | + - 3CCFE575CT Tornado CardBus | |
| 64 | + - 3CCFE656 Cyclone CardBus | |
| 65 | + - 3CCFEM656B Cyclone+Winmodem CardBus | |
| 66 | + - 3CXFEM656C Tornado+Winmodem CardBus | |
| 67 | + - 3c450 HomePNA Tornado | |
| 68 | + - 3c920 Tornado | |
| 69 | + - 3c982 Hydra Dual Port A | |
| 70 | + - 3c982 Hydra Dual Port B | |
| 71 | + - 3c905B-T4 | |
| 72 | + - 3c920B-EMB-WNM Tornado | |
| 65 | 73 | |
| 66 | 74 | Module parameters |
| 67 | 75 | ================= |
| 68 | 76 | |
| 69 | 77 | There are several parameters which may be provided to the driver when |
| 70 | −its module is loaded. These are usually placed in /etc/modprobe.d/*.conf | |
| 71 | −configuration files. Example: | |
| 78 | +its module is loaded. These are usually placed in ``/etc/modprobe.d/*.conf`` | |
| 79 | +configuration files. Example:: | |
| 72 | 80 | |
| 73 | −options 3c59x debug=3 rx_copybreak=300 | |
| 81 | + options 3c59x debug=3 rx_copybreak=300 | |
| 74 | 82 | |
| 75 | 83 | If you are using the PCMCIA tools (cardmgr) then the options may be |
| 76 | −placed in /etc/pcmcia/config.opts: | |
| 84 | +placed in /etc/pcmcia/config.opts:: | |
| 77 | 85 | |
| 78 | −module "3c59x" opts "debug=3 rx_copybreak=300" | |
| 86 | + module "3c59x" opts "debug=3 rx_copybreak=300" | |
| 79 | 87 | |
| 80 | 88 | |
| 81 | 89 | The supported parameters are: |
| @@ -89,7 +97,7 @@ options=N1,N2,N3,... · 7 unmodified lines | ||
| 89 | 97 | |
| 90 | 98 | Each number in the list provides an option to the corresponding |
| 91 | 99 | network card. So if you have two 3c905's and you wish to provide |
| 92 | − them with option 0x204 you would use: | |
| 100 | + them with option 0x204 you would use:: | |
| 93 | 101 | |
| 94 | 102 | options=0x204,0x204 |
| 95 | 103 | |
| @@ -97,6 +105,8 @@ options=N1,N2,N3,... · 1 unmodified line | ||
| 97 | 105 | have the following meanings: |
| 98 | 106 | |
| 99 | 107 | Possible media type settings |
| 108 | + | |
| 109 | + == ================================= | |
| 100 | 110 | 0 10baseT |
| 101 | 111 | 1 10Mbs AUI |
| 102 | 112 | 2 undefined |
| @@ -108,17 +118,20 @@ options=N1,N2,N3,... · 5 unmodified lines | ||
| 108 | 118 | 8 Autonegotiate |
| 109 | 119 | 9 External MII |
| 110 | 120 | 10 Use default setting from EEPROM |
| 121 | + == ================================= | |
| 111 | 122 | |
| 112 | 123 | When generating a value for the 'options' setting, the above media |
| 113 | 124 | selection values may be OR'ed (or added to) the following: |
| 114 | 125 | |
| 126 | + ====== ============================================= | |
| 115 | 127 | 0x8000 Set driver debugging level to 7 |
| 116 | 128 | 0x4000 Set driver debugging level to 2 |
| 117 | 129 | 0x0400 Enable Wake-on-LAN |
| 118 | 130 | 0x0200 Force full duplex mode. |
| 119 | 131 | 0x0010 Bus-master enable bit (Old Vortex cards only) |
| 132 | + ====== ============================================= | |
| 120 | 133 | |
| 121 | − For example: | |
| 134 | + For example:: | |
| 122 | 135 | |
| 123 | 136 | insmod 3c59x options=0x204 |
| 124 | 137 | |
| @@ -127,14 +140,14 @@ options=N1,N2,N3,... · 2 unmodified lines | ||
| 127 | 140 | |
| 128 | 141 | global_options=N |
| 129 | 142 | |
| 130 | − Sets the `options' parameter for all 3c59x NICs in the machine. | |
| 131 | − Entries in the `options' array above will override any setting of | |
| 143 | + Sets the ``options`` parameter for all 3c59x NICs in the machine. | |
| 144 | + Entries in the ``options`` array above will override any setting of | |
| 132 | 145 | this. |
| 133 | 146 | |
| 134 | 147 | full_duplex=N1,N2,N3... |
| 135 | 148 | |
| 136 | 149 | Similar to bit 9 of 'options'. Forces the corresponding card into |
| 137 | − full-duplex mode. Please use this in preference to the `options' | |
| 150 | + full-duplex mode. Please use this in preference to the ``options`` | |
| 138 | 151 | parameter. |
| 139 | 152 | |
| 140 | 153 | In fact, please don't use this at all! You're better off getting |
| @@ -143,13 +156,13 @@ full_duplex=N1,N2,N3... · 2 unmodified lines | ||
| 143 | 156 | global_full_duplex=N1 |
| 144 | 157 | |
| 145 | 158 | Sets full duplex mode for all 3c59x NICs in the machine. Entries |
| 146 | − in the `full_duplex' array above will override any setting of this. | |
| 159 | + in the ``full_duplex`` array above will override any setting of this. | |
| 147 | 160 | |
| 148 | 161 | flow_ctrl=N1,N2,N3... |
| 149 | 162 | |
| 150 | 163 | Use 802.3x MAC-layer flow control. The 3com cards only support the |
| 151 | 164 | PAUSE command, which means that they will stop sending packets for a |
| 152 | − short period if they receive a PAUSE frame from the link partner. | |
| 165 | + short period if they receive a PAUSE frame from the link partner. | |
| 153 | 166 | |
| 154 | 167 | The driver only allows flow control on a link which is operating in |
| 155 | 168 | full duplex mode. |
| @@ -170,14 +183,14 @@ rx_copybreak=M · 14 unmodified lines | ||
| 170 | 183 | |
| 171 | 184 | This is a speed/space tradeoff. |
| 172 | 185 | |
| 173 | − The value of rx_copybreak is used to decide when to make the copy. | |
| 174 | − If the packet size is less than rx_copybreak, the packet is copied. | |
| 186 | + The value of rx_copybreak is used to decide when to make the copy. | |
| 187 | + If the packet size is less than rx_copybreak, the packet is copied. | |
| 175 | 188 | The default value for rx_copybreak is 200 bytes. |
| 176 | 189 | |
| 177 | 190 | max_interrupt_work=N |
| 178 | 191 | |
| 179 | 192 | The driver's interrupt service routine can handle many receive and |
| 180 | − transmit packets in a single invocation. It does this in a loop. | |
| 193 | + transmit packets in a single invocation. It does this in a loop. | |
| 181 | 194 | The value of max_interrupt_work governs how many times the interrupt |
| 182 | 195 | service routine will loop. The default value is 32 loops. If this |
| 183 | 196 | is exceeded the interrupt service routine gives up and generates a |
| @@ -186,7 +199,7 @@ max_interrupt_work=N · 2 unmodified lines | ||
| 186 | 199 | hw_checksums=N1,N2,N3,... |
| 187 | 200 | |
| 188 | 201 | Recent 3com NICs are able to generate IPv4, TCP and UDP checksums |
| 189 | − in hardware. Linux has used the Rx checksumming for a long time. | |
| 202 | + in hardware. Linux has used the Rx checksumming for a long time. | |
| 190 | 203 | The "zero copy" patch which is planned for the 2.4 kernel series |
| 191 | 204 | allows you to make use of the NIC's DMA scatter/gather and transmit |
| 192 | 205 | checksumming as well. |
| @@ -196,11 +209,11 @@ hw_checksums=N1,N2,N3,... · 3 unmodified lines | ||
| 196 | 209 | |
| 197 | 210 | This module parameter has been provided so you can override this |
| 198 | 211 | decision. If you think that Tx checksums are causing a problem, you |
| 199 | − may disable the feature with `hw_checksums=0'. | |
| 212 | + may disable the feature with ``hw_checksums=0``. | |
| 200 | 213 | |
| 201 | 214 | If you think your NIC should be performing Tx checksumming and the |
| 202 | 215 | driver isn't enabling it, you can force the use of hardware Tx |
| 203 | − checksumming with `hw_checksums=1'. | |
| 216 | + checksumming with ``hw_checksums=1``. | |
| 204 | 217 | |
| 205 | 218 | The driver drops a message in the logfiles to indicate whether or |
| 206 | 219 | not it is using hardware scatter/gather and hardware Tx checksums. |
| @@ -210,8 +223,8 @@ hw_checksums=N1,N2,N3,... · 3 unmodified lines | ||
| 210 | 223 | decrease in throughput for send(). There is no effect upon receive |
| 211 | 224 | efficiency. |
| 212 | 225 | |
| 213 | −compaq_ioaddr=N | |
| 214 | −compaq_irq=N | |
| 226 | +compaq_ioaddr=N, | |
| 227 | +compaq_irq=N, | |
| 215 | 228 | compaq_device_id=N |
| 216 | 229 | |
| 217 | 230 | "Variables to work-around the Compaq PCI BIOS32 problem".... |
| @@ -219,7 +232,7 @@ compaq_device_id=N · 1 unmodified line | ||
| 219 | 232 | watchdog=N |
| 220 | 233 | |
| 221 | 234 | Sets the time duration (in milliseconds) after which the kernel |
| 222 | − decides that the transmitter has become stuck and needs to be reset. | |
| 235 | + decides that the transmitter has become stuck and needs to be reset. | |
| 223 | 236 | This is mainly for debugging purposes, although it may be advantageous |
| 224 | 237 | to increase this value on LANs which have very high collision rates. |
| 225 | 238 | The default value is 5000 (5.0 seconds). |
| @@ -227,7 +240,7 @@ watchdog=N · 1 unmodified line | ||
| 227 | 240 | enable_wol=N1,N2,N3,... |
| 228 | 241 | |
| 229 | 242 | Enable Wake-on-LAN support for the relevant interface. Donald |
| 230 | − Becker's `ether-wake' application may be used to wake suspended | |
| 243 | + Becker's ``ether-wake`` application may be used to wake suspended | |
| 231 | 244 | machines. |
| 232 | 245 | |
| 233 | 246 | Also enables the NIC's power management support. |
| @@ -235,7 +248,7 @@ enable_wol=N1,N2,N3,... · 1 unmodified line | ||
| 235 | 248 | global_enable_wol=N |
| 236 | 249 | |
| 237 | 250 | Sets enable_wol mode for all 3c59x NICs in the machine. Entries in |
| 238 | − the `enable_wol' array above will override any setting of this. | |
| 251 | + the ``enable_wol`` array above will override any setting of this. | |
| 239 | 252 | |
| 240 | 253 | Media selection |
| 241 | 254 | --------------- |
| @@ -325,12 +338,12 @@ Autonegotiation notes · 83 unmodified lines | ||
| 325 | 338 | |
| 326 | 339 | Cisco switches (Jeff Busch <jbusch@deja.com>) |
| 327 | 340 | |
| 328 | − My "standard config" for ports to which PC's/servers connect directly: | |
| 341 | + My "standard config" for ports to which PC's/servers connect directly:: | |
| 329 | 342 | |
| 330 | − interface FastEthernet0/N | |
| 331 | − description machinename | |
| 332 | − load-interval 30 | |
| 333 | − spanning-tree portfast | |
| 343 | + interface FastEthernet0/N | |
| 344 | + description machinename | |
| 345 | + load-interval 30 | |
| 346 | + spanning-tree portfast | |
| 334 | 347 | |
| 335 | 348 | If autonegotiation is a problem, you may need to specify "speed |
| 336 | 349 | 100" and "duplex full" as well (or "speed 10" and "duplex half"). |
| @@ -368,9 +381,9 @@ steps you should take: · 31 unmodified lines | ||
| 368 | 381 | |
| 369 | 382 | But for most problems it is useful to provide the following: |
| 370 | 383 | |
| 371 | − o Kernel version, driver version | |
| 384 | + - Kernel version, driver version | |
| 372 | 385 | |
| 373 | − o A copy of the banner message which the driver generates when | |
| 386 | + - A copy of the banner message which the driver generates when | |
| 374 | 387 | it is initialised. For example: |
| 375 | 388 | |
| 376 | 389 | eth0: 3Com PCI 3c905C Tornado at 0xa400, 00:50:da:6a:88:f0, IRQ 19 |
| @@ -378,68 +391,68 @@ steps you should take: · 1 unmodified line | ||
| 378 | 391 | MII transceiver found at address 24, status 782d. |
| 379 | 392 | Enabling bus-master transmits and whole-frame receives. |
| 380 | 393 | |
| 381 | − NOTE: You must provide the `debug=2' modprobe option to generate | |
| 382 | − a full detection message. Please do this: | |
| 394 | + NOTE: You must provide the ``debug=2`` modprobe option to generate | |
| 395 | + a full detection message. Please do this:: | |
| 383 | 396 | |
| 384 | 397 | modprobe 3c59x debug=2 |
| 385 | 398 | |
| 386 | − o If it is a PCI device, the relevant output from 'lspci -vx', eg: | |
| 387 | − | |
| 388 | − 00:09.0 Ethernet controller: 3Com Corporation 3c905C-TX [Fast Etherlink] (rev 74) | |
| 389 | − Subsystem: 3Com Corporation: Unknown device 9200 | |
| 390 | − Flags: bus master, medium devsel, latency 32, IRQ 19 | |
| 391 | − I/O ports at a400 [size=128] | |
| 392 | − Memory at db000000 (32-bit, non-prefetchable) [size=128] | |
| 393 | − Expansion ROM at <unassigned> [disabled] [size=128K] | |
| 394 | − Capabilities: [dc] Power Management version 2 | |
| 395 | − 00: b7 10 00 92 07 00 10 02 74 00 00 02 08 20 00 00 | |
| 396 | − 10: 01 a4 00 00 00 00 00 db 00 00 00 00 00 00 00 00 | |
| 397 | − 20: 00 00 00 00 00 00 00 00 00 00 00 00 b7 10 00 10 | |
| 398 | − 30: 00 00 00 00 dc 00 00 00 00 00 00 00 05 01 0a 0a | |
| 399 | − | |
| 400 | − o A description of the environment: 10baseT? 100baseT? | |
| 399 | + - If it is a PCI device, the relevant output from 'lspci -vx', eg:: | |
| 400 | + | |
| 401 | + 00:09.0 Ethernet controller: 3Com Corporation 3c905C-TX [Fast Etherlink] (rev 74) | |
| 402 | + Subsystem: 3Com Corporation: Unknown device 9200 | |
| 403 | + Flags: bus master, medium devsel, latency 32, IRQ 19 | |
| 404 | + I/O ports at a400 [size=128] | |
| 405 | + Memory at db000000 (32-bit, non-prefetchable) [size=128] | |
| 406 | + Expansion ROM at <unassigned> [disabled] [size=128K] | |
| 407 | + Capabilities: [dc] Power Management version 2 | |
| 408 | + 00: b7 10 00 92 07 00 10 02 74 00 00 02 08 20 00 00 | |
| 409 | + 10: 01 a4 00 00 00 00 00 db 00 00 00 00 00 00 00 00 | |
| 410 | + 20: 00 00 00 00 00 00 00 00 00 00 00 00 b7 10 00 10 | |
| 411 | + 30: 00 00 00 00 dc 00 00 00 00 00 00 00 05 01 0a 0a | |
| 412 | + | |
| 413 | + - A description of the environment: 10baseT? 100baseT? | |
| 401 | 414 | full/half duplex? switched or hubbed? |
| 402 | 415 | |
| 403 | − o Any additional module parameters which you may be providing to the driver. | |
| 416 | + - Any additional module parameters which you may be providing to the driver. | |
| 404 | 417 | |
| 405 | − o Any kernel logs which are produced. The more the merrier. | |
| 418 | + - Any kernel logs which are produced. The more the merrier. | |
| 406 | 419 | If this is a large file and you are sending your report to a |
| 407 | 420 | mailing list, mention that you have the logfile, but don't send |
| 408 | 421 | it. If you're reporting direct to the maintainer then just send |
| 409 | 422 | it. |
| 410 | 423 | |
| 411 | 424 | To ensure that all kernel logs are available, add the |
| 412 | − following line to /etc/syslog.conf: | |
| 425 | + following line to /etc/syslog.conf:: | |
| 413 | 426 | |
| 414 | − kern.* /var/log/messages | |
| 427 | + kern.* /var/log/messages | |
| 415 | 428 | |
| 416 | − Then restart syslogd with: | |
| 429 | + Then restart syslogd with:: | |
| 417 | 430 | |
| 418 | − /etc/rc.d/init.d/syslog restart | |
| 431 | + /etc/rc.d/init.d/syslog restart | |
| 419 | 432 | |
| 420 | 433 | (The above may vary, depending upon which Linux distribution you use). |
| 421 | 434 | |
| 422 | − o If your problem is reproducible then that's great. Try the | |
| 435 | + - If your problem is reproducible then that's great. Try the | |
| 423 | 436 | following: |
| 424 | 437 | |
| 425 | 438 | 1) Increase the debug level. Usually this is done via: |
| 426 | 439 | |
| 427 | − a) modprobe driver debug=7 | |
| 428 | − b) In /etc/modprobe.d/driver.conf: | |
| 429 | − options driver debug=7 | |
| 440 | + a) modprobe driver debug=7 | |
| 441 | + b) In /etc/modprobe.d/driver.conf: | |
| 442 | + options driver debug=7 | |
| 430 | 443 | |
| 431 | 444 | 2) Recreate the problem with the higher debug level, |
| 432 | − send all logs to the maintainer. | |
| 445 | + send all logs to the maintainer. | |
| 433 | 446 | |
| 434 | 447 | 3) Download you card's diagnostic tool from Donald |
| 435 | − Becker's website <http://www.scyld.com/ethercard_diag.html>. | |
| 436 | − Download mii-diag.c as well. Build these. | |
| 448 | + Becker's website <http://www.scyld.com/ethercard_diag.html>. | |
| 449 | + Download mii-diag.c as well. Build these. | |
| 437 | 450 | |
| 438 | − a) Run 'vortex-diag -aaee' and 'mii-diag -v' when the card is | |
| 439 | − working correctly. Save the output. | |
| 451 | + a) Run 'vortex-diag -aaee' and 'mii-diag -v' when the card is | |
| 452 | + working correctly. Save the output. | |
| 440 | 453 | |
| 441 | − b) Run the above commands when the card is malfunctioning. Send | |
| 442 | − both sets of output. | |
| 454 | + b) Run the above commands when the card is malfunctioning. Send | |
| 455 | + both sets of output. | |
| 443 | 456 | |
| 444 | 457 | Finally, please be patient and be prepared to do some work. You may |
| 445 | 458 | end up working on this problem for a week or more as the maintainer |
| @@ -1,8 +1,12 @@ | ||
| 1 | −Linux kernel driver for Elastic Network Adapter (ENA) family: | |
| 2 | −============================================================= | |
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +============================================================ | |
| 4 | +Linux kernel driver for Elastic Network Adapter (ENA) family | |
| 5 | +============================================================ | |
| 6 | + | |
| 7 | +Overview | |
| 8 | +======== | |
| 3 | 9 | |
| 4 | −Overview: | |
| 5 | −========= | |
| 6 | 10 | ENA is a networking interface designed to make good use of modern CPU |
| 7 | 11 | features and system architectures. |
| 8 | 12 | |
| @@ -35,32 +39,40 @@ debug logs. · 26 unmodified lines | ||
| 35 | 39 | Some of the ENA devices support a working mode called Low-latency |
| 36 | 40 | Queue (LLQ), which saves several more microseconds. |
| 37 | 41 | |
| 38 | −Supported PCI vendor ID/device IDs: | |
| 42 | +Supported PCI vendor ID/device IDs | |
| 43 | +================================== | |
| 44 | + | |
| 45 | +========= ======================= | |
| 46 | +1d0f:0ec2 ENA PF | |
| 47 | +1d0f:1ec2 ENA PF with LLQ support | |
| 48 | +1d0f:ec20 ENA VF | |
| 49 | +1d0f:ec21 ENA VF with LLQ support | |
| 50 | +========= ======================= | |
| 51 | + | |
| 52 | +ENA Source Code Directory Structure | |
| 39 | 53 | =================================== |
| 40 | −1d0f:0ec2 - ENA PF | |
| 41 | −1d0f:1ec2 - ENA PF with LLQ support | |
| 42 | −1d0f:ec20 - ENA VF | |
| 43 | −1d0f:ec21 - ENA VF with LLQ support | |
| 44 | − | |
| 45 | −ENA Source Code Directory Structure: | |
| 46 | −==================================== | |
| 47 | −ena_com.[ch] - Management communication layer. This layer is | |
| 48 | − responsible for the handling all the management | |
| 49 | − (admin) communication between the device and the | |
| 50 | − driver. | |
| 51 | −ena_eth_com.[ch] - Tx/Rx data path. | |
| 52 | −ena_admin_defs.h - Definition of ENA management interface. | |
| 53 | −ena_eth_io_defs.h - Definition of ENA data path interface. | |
| 54 | −ena_common_defs.h - Common definitions for ena_com layer. | |
| 55 | −ena_regs_defs.h - Definition of ENA PCI memory-mapped (MMIO) registers. | |
| 56 | −ena_netdev.[ch] - Main Linux kernel driver. | |
| 57 | −ena_syfsfs.[ch] - Sysfs files. | |
| 58 | −ena_ethtool.c - ethtool callbacks. | |
| 59 | −ena_pci_id_tbl.h - Supported device IDs. | |
| 54 | + | |
| 55 | +================= ====================================================== | |
| 56 | +ena_com.[ch] Management communication layer. This layer is | |
| 57 | + responsible for the handling all the management | |
| 58 | + (admin) communication between the device and the | |
| 59 | + driver. | |
| 60 | +ena_eth_com.[ch] Tx/Rx data path. | |
| 61 | +ena_admin_defs.h Definition of ENA management interface. | |
| 62 | +ena_eth_io_defs.h Definition of ENA data path interface. | |
| 63 | +ena_common_defs.h Common definitions for ena_com layer. | |
| 64 | +ena_regs_defs.h Definition of ENA PCI memory-mapped (MMIO) registers. | |
| 65 | +ena_netdev.[ch] Main Linux kernel driver. | |
| 66 | +ena_syfsfs.[ch] Sysfs files. | |
| 67 | +ena_ethtool.c ethtool callbacks. | |
| 68 | +ena_pci_id_tbl.h Supported device IDs. | |
| 69 | +================= ====================================================== | |
| 60 | 70 | |
| 61 | 71 | Management Interface: |
| 62 | 72 | ===================== |
| 73 | + | |
| 63 | 74 | ENA management interface is exposed by means of: |
| 75 | + | |
| 64 | 76 | - PCIe Configuration Space |
| 65 | 77 | - Device Registers |
| 66 | 78 | - Admin Queue (AQ) and Admin Completion Queue (ACQ) |
| @@ -78,6 +90,7 @@ vendor-specific extensions. Most of the management operations are · 11 unmodified lines | ||
| 78 | 90 | framed in a generic Get/Set feature command. |
| 79 | 91 | |
| 80 | 92 | The following admin queue commands are supported: |
| 93 | + | |
| 81 | 94 | - Create I/O submission queue |
| 82 | 95 | - Create I/O completion queue |
| 83 | 96 | - Destroy I/O submission queue |
| @@ -96,12 +109,16 @@ be reported using ACQ. AENQ events are subdivided into groups. Each · 12 unmodified lines | ||
| 96 | 109 | group may have multiple syndromes, as shown below |
| 97 | 110 | |
| 98 | 111 | The events are: |
| 112 | + | |
| 113 | + ==================== =============== | |
| 99 | 114 | Group Syndrome |
| 100 | − Link state change - X - | |
| 101 | − Fatal error - X - | |
| 115 | + ==================== =============== | |
| 116 | + Link state change **X** | |
| 117 | + Fatal error **X** | |
| 102 | 118 | Notification Suspend traffic |
| 103 | 119 | Notification Resume traffic |
| 104 | − Keep-Alive - X - | |
| 120 | + Keep-Alive **X** | |
| 121 | + ==================== =============== | |
| 105 | 122 | |
| 106 | 123 | ACQ and AENQ share the same MSI-X vector. |
| 107 | 124 | |
| @@ -113,8 +130,8 @@ the device every second. The driver re-arms the WD upon reception of a · 5 unmodified lines | ||
| 113 | 130 | Keep-Alive event. A missed Keep-Alive event causes the WD handler to |
| 114 | 131 | fire. |
| 115 | 132 | |
| 116 | −Data Path Interface: | |
| 117 | −==================== | |
| 133 | +Data Path Interface | |
| 134 | +=================== | |
| 118 | 135 | I/O operations are based on Tx and Rx Submission Queues (Tx SQ and Rx |
| 119 | 136 | SQ correspondingly). Each SQ has a completion queue (CQ) associated |
| 120 | 137 | with it. |
| @@ -123,11 +140,15 @@ The SQs and CQs are implemented as descriptor rings in contiguous · 2 unmodified lines | ||
| 123 | 140 | physical memory. |
| 124 | 141 | |
| 125 | 142 | The ENA driver supports two Queue Operation modes for Tx SQs: |
| 143 | + | |
| 126 | 144 | - Regular mode |
| 145 | + | |
| 127 | 146 | * In this mode the Tx SQs reside in the host's memory. The ENA |
| 128 | 147 | device fetches the ENA Tx descriptors and packet data from host |
| 129 | 148 | memory. |
| 149 | + | |
| 130 | 150 | - Low Latency Queue (LLQ) mode or "push-mode". |
| 151 | + | |
| 131 | 152 | * In this mode the driver pushes the transmit descriptors and the |
| 132 | 153 | first 128 bytes of the packet directly to the ENA device memory |
| 133 | 154 | space. The rest of the packet payload is fetched by the |
| @@ -142,6 +163,7 @@ Note: Not all ENA devices support LLQ, and this feature is negotiated · 8 unmodified lines | ||
| 142 | 163 | |
| 143 | 164 | The driver supports multi-queue for both Tx and Rx. This has various |
| 144 | 165 | benefits: |
| 166 | + | |
| 145 | 167 | - Reduced CPU/thread/process contention on a given Ethernet interface. |
| 146 | 168 | - Cache miss rate on completion is reduced, particularly for data |
| 147 | 169 | cache lines that hold the sk_buff structures. |
| @@ -151,8 +173,8 @@ benefits: · 3 unmodified lines | ||
| 151 | 173 | packet is running. |
| 152 | 174 | - In hardware interrupt re-direction. |
| 153 | 175 | |
| 154 | −Interrupt Modes: | |
| 155 | −================ | |
| 176 | +Interrupt Modes | |
| 177 | +=============== | |
| 156 | 178 | The driver assigns a single MSI-X vector per queue pair (for both Tx |
| 157 | 179 | and Rx directions). The driver assigns an additional dedicated MSI-X vector |
| 158 | 180 | for management (for ACQ and AENQ). |
| @@ -163,9 +185,12 @@ removed. I/O queue interrupt registration is performed when the Linux · 4 unmodified lines | ||
| 163 | 185 | interface of the adapter is opened, and it is de-registered when the |
| 164 | 186 | interface is closed. |
| 165 | 187 | |
| 166 | −The management interrupt is named: | |
| 188 | +The management interrupt is named:: | |
| 189 | + | |
| 167 | 190 | ena-mgmnt@pci:<PCI domain:bus:slot.function> |
| 168 | −and for each queue pair, an interrupt is named: | |
| 191 | + | |
| 192 | +and for each queue pair, an interrupt is named:: | |
| 193 | + | |
| 169 | 194 | <interface name>-Tx-Rx-<queue index> |
| 170 | 195 | |
| 171 | 196 | The ENA device operates in auto-mask and auto-clear interrupt |
| @@ -173,8 +198,8 @@ modes. That is, once MSI-X is delivered to the host, its Cause bit is · 1 unmodified line | ||
| 173 | 198 | automatically cleared and the interrupt is masked. The interrupt is |
| 174 | 199 | unmasked by the driver after NAPI processing is complete. |
| 175 | 200 | |
| 176 | −Interrupt Moderation: | |
| 177 | −===================== | |
| 201 | +Interrupt Moderation | |
| 202 | +==================== | |
| 178 | 203 | ENA driver and device can operate in conventional or adaptive interrupt |
| 179 | 204 | moderation mode. |
| 180 | 205 | |
| @@ -202,45 +227,46 @@ delay value to each level. · 21 unmodified lines | ||
| 202 | 227 | The user can enable/disable adaptive moderation, modify the interrupt |
| 203 | 228 | delay table and restore its default values through sysfs. |
| 204 | 229 | |
| 205 | −RX copybreak: | |
| 206 | −============= | |
| 230 | +RX copybreak | |
| 231 | +============ | |
| 207 | 232 | The rx_copybreak is initialized by default to ENA_DEFAULT_RX_COPYBREAK |
| 208 | 233 | and can be configured by the ETHTOOL_STUNABLE command of the |
| 209 | 234 | SIOCETHTOOL ioctl. |
| 210 | 235 | |
| 211 | −SKB: | |
| 212 | −==== | |
| 236 | +SKB | |
| 237 | +=== | |
| 213 | 238 | The driver-allocated SKB for frames received from Rx handling using |
| 214 | 239 | NAPI context. The allocation method depends on the size of the packet. |
| 215 | 240 | If the frame length is larger than rx_copybreak, napi_get_frags() |
| 216 | 241 | is used, otherwise netdev_alloc_skb_ip_align() is used, the buffer |
| 217 | 242 | content is copied (by CPU) to the SKB, and the buffer is recycled. |
| 218 | 243 | |
| 219 | −Statistics: | |
| 220 | −=========== | |
| 244 | +Statistics | |
| 245 | +========== | |
| 221 | 246 | The user can obtain ENA device and driver statistics using ethtool. |
| 222 | 247 | The driver can collect regular or extended statistics (including |
| 223 | 248 | per-queue stats) from the device. |
| 224 | 249 | |
| 225 | 250 | In addition the driver logs the stats to syslog upon device reset. |
| 226 | 251 | |
| 227 | −MTU: | |
| 228 | −==== | |
| 252 | +MTU | |
| 253 | +=== | |
| 229 | 254 | The driver supports an arbitrarily large MTU with a maximum that is |
| 230 | 255 | negotiated with the device. The driver configures MTU using the |
| 231 | 256 | SetFeature command (ENA_ADMIN_MTU property). The user can change MTU |
| 232 | 257 | via ip(8) and similar legacy tools. |
| 233 | 258 | |
| 234 | −Stateless Offloads: | |
| 235 | −=================== | |
| 259 | +Stateless Offloads | |
| 260 | +================== | |
| 236 | 261 | The ENA driver supports: |
| 262 | + | |
| 237 | 263 | - TSO over IPv4/IPv6 |
| 238 | 264 | - TSO with ECN |
| 239 | 265 | - IPv4 header checksum offload |
| 240 | 266 | - TCP/UDP over IPv4/IPv6 checksum offloads |
| 241 | 267 | |
| 242 | −RSS: | |
| 243 | −==== | |
| 268 | +RSS | |
| 269 | +=== | |
| 244 | 270 | - The ENA device supports RSS that allows flexible Rx traffic |
| 245 | 271 | steering. |
| 246 | 272 | - Toeplitz and CRC32 hash functions are supported. |
| @@ -255,11 +281,13 @@ RSS: · 8 unmodified lines | ||
| 255 | 281 | - The user can provide a hash key, hash function, and configure the |
| 256 | 282 | indirection table through ethtool(8). |
| 257 | 283 | |
| 258 | −DATA PATH: | |
| 259 | −========== | |
| 260 | −Tx: | |
| 261 | −--- | |
| 284 | +DATA PATH | |
| 285 | +========= | |
| 286 | +Tx | |
| 287 | +-- | |
| 288 | + | |
| 262 | 289 | end_start_xmit() is called by the stack. This function does the following: |
| 290 | + | |
| 263 | 291 | - Maps data buffers (skb->data and frags). |
| 264 | 292 | - Populates ena_buf for the push buffer (if the driver and device are |
| 265 | 293 | in push mode.) |
| @@ -271,8 +299,10 @@ end_start_xmit() is called by the stack. This function does the following: · 5 unmodified lines | ||
| 271 | 299 | - Calls ena_com_prepare_tx(), an ENA communication layer that converts |
| 272 | 300 | the ena_bufs to ENA descriptors (and adds meta ENA descriptors as |
| 273 | 301 | needed.) |
| 302 | + | |
| 274 | 303 | * This function also copies the ENA descriptors and the push buffer |
| 275 | 304 | to the Device memory space (if in push mode.) |
| 305 | + | |
| 276 | 306 | - Writes doorbell to the ENA device. |
| 277 | 307 | - When the ENA device finishes sending the packet, a completion |
| 278 | 308 | interrupt is raised. |
| @@ -280,14 +310,16 @@ end_start_xmit() is called by the stack. This function does the following: · 1 unmodified line | ||
| 280 | 310 | - The ena_clean_tx_irq() function is called. This function handles the |
| 281 | 311 | completion descriptors generated by the ENA, with a single |
| 282 | 312 | completion descriptor per completed packet. |
| 313 | + | |
| 283 | 314 | * req_id is retrieved from the completion descriptor. The tx_info of |
| 284 | 315 | the packet is retrieved via the req_id. The data buffers are |
| 285 | 316 | unmapped and req_id is returned to the empty req_id ring. |
| 286 | 317 | * The function stops when the completion descriptors are completed or |
| 287 | 318 | the budget is reached. |
| 288 | 319 | |
| 289 | −Rx: | |
| 290 | −--- | |
| 320 | +Rx | |
| 321 | +-- | |
| 322 | + | |
| 291 | 323 | - When a packet is received from the ENA device. |
| 292 | 324 | - The interrupt handler schedules NAPI. |
| 293 | 325 | - The ena_clean_rx_irq() function is called. This function calls |
| @@ -296,13 +328,17 @@ Rx: · 2 unmodified lines | ||
| 296 | 328 | no new packet is found. |
| 297 | 329 | - Then it calls the ena_clean_rx_irq() function. |
| 298 | 330 | - ena_eth_rx_skb() checks packet length: |
| 331 | + | |
| 299 | 332 | * If the packet is small (len < rx_copybreak), the driver allocates |
| 300 | 333 | a SKB for the new packet, and copies the packet payload into the |
| 301 | 334 | SKB data buffer. |
| 335 | + | |
| 302 | 336 | - In this way the original data buffer is not passed to the stack |
| 303 | 337 | and is reused for future Rx packets. |
| 338 | + | |
| 304 | 339 | * Otherwise the function unmaps the Rx buffer, then allocates the |
| 305 | 340 | new SKB structure and hooks the Rx buffer to the SKB frags. |
| 341 | + | |
| 306 | 342 | - The new SKB is updated with the necessary information (protocol, |
| 307 | 343 | checksum hw verify result, etc.), and then passed to the network |
| 308 | 344 | stack, using the NAPI interface function napi_gro_receive(). |
| @@ -1,83 +1,96 @@ | ||
| 1 | −Marvell(Aquantia) AQtion Driver for the aQuantia Multi-Gigabit PCI Express | |
| 2 | −Family of Ethernet Adapters | |
| 3 | −============================================================================= | |
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | +.. include:: <isonum.txt> | |
| 4 | 3 | |
| 5 | −Contents | |
| 6 | −======== | |
| 4 | +=============================== | |
| 5 | +Marvell(Aquantia) AQtion Driver | |
| 6 | +=============================== | |
| 7 | 7 | |
| 8 | −- Identifying Your Adapter | |
| 9 | −- Configuration | |
| 10 | −- Supported ethtool options | |
| 11 | −- Command Line Parameters | |
| 12 | −- Config file parameters | |
| 13 | −- Support | |
| 14 | −- License | |
| 8 | +For the aQuantia Multi-Gigabit PCI Express Family of Ethernet Adapters | |
| 9 | + | |
| 10 | +.. Contents | |
| 11 | + | |
| 12 | + - Identifying Your Adapter | |
| 13 | + - Configuration | |
| 14 | + - Supported ethtool options | |
| 15 | + - Command Line Parameters | |
| 16 | + - Config file parameters | |
| 17 | + - Support | |
| 18 | + - License | |
| 15 | 19 | |
| 16 | 20 | Identifying Your Adapter |
| 17 | 21 | ======================== |
| 18 | 22 | |
| 19 | −The driver in this release is compatible with AQC-100, AQC-107, AQC-108 based ethernet adapters. | |
| 23 | +The driver in this release is compatible with AQC-100, AQC-107, AQC-108 | |
| 24 | +based ethernet adapters. | |
| 20 | 25 | |
| 21 | 26 | |
| 22 | 27 | SFP+ Devices (for AQC-100 based adapters) |
| 23 | −---------------------------------- | |
| 28 | +----------------------------------------- | |
| 24 | 29 | |
| 25 | −This release tested with passive Direct Attach Cables (DAC) and SFP+/LC Optical Transceiver. | |
| 30 | +This release tested with passive Direct Attach Cables (DAC) and SFP+/LC | |
| 31 | +Optical Transceiver. | |
| 26 | 32 | |
| 27 | 33 | Configuration |
| 28 | −========================= | |
| 29 | − Viewing Link Messages | |
| 30 | − --------------------- | |
| 34 | +============= | |
| 35 | + | |
| 36 | +Viewing Link Messages | |
| 37 | +--------------------- | |
| 31 | 38 | Link messages will not be displayed to the console if the distribution is |
| 32 | 39 | restricting system messages. In order to see network driver link messages on |
| 33 | − your console, set dmesg to eight by entering the following: | |
| 40 | + your console, set dmesg to eight by entering the following:: | |
| 34 | 41 | |
| 35 | 42 | dmesg -n 8 |
| 36 | 43 | |
| 37 | − NOTE: This setting is not saved across reboots. | |
| 44 | + .. note:: | |
| 38 | 45 | |
| 39 | − Jumbo Frames | |
| 40 | − ------------ | |
| 46 | + This setting is not saved across reboots. | |
| 47 | + | |
| 48 | +Jumbo Frames | |
| 49 | +------------ | |
| 41 | 50 | The driver supports Jumbo Frames for all adapters. Jumbo Frames support is |
| 42 | 51 | enabled by changing the MTU to a value larger than the default of 1500. |
| 43 | 52 | The maximum value for the MTU is 16000. Use the `ip` command to |
| 44 | − increase the MTU size. For example: | |
| 53 | + increase the MTU size. For example:: | |
| 45 | 54 | |
| 46 | − ip link set mtu 16000 dev enp1s0 | |
| 55 | + ip link set mtu 16000 dev enp1s0 | |
| 47 | 56 | |
| 48 | − ethtool | |
| 49 | − ------- | |
| 57 | +ethtool | |
| 58 | +------- | |
| 50 | 59 | The driver utilizes the ethtool interface for driver configuration and |
| 51 | 60 | diagnostics, as well as displaying statistical information. The latest |
| 52 | 61 | ethtool version is required for this functionality. |
| 53 | 62 | |
| 54 | − NAPI | |
| 55 | − ---- | |
| 63 | +NAPI | |
| 64 | +---- | |
| 56 | 65 | NAPI (Rx polling mode) is supported in the atlantic driver. |
| 57 | 66 | |
| 58 | 67 | Supported ethtool options |
| 59 | −============================ | |
| 60 | − Viewing adapter settings | |
| 61 | − --------------------- | |
| 62 | − ethtool <ethX> | |
| 68 | +========================= | |
| 69 | + | |
| 70 | +Viewing adapter settings | |
| 71 | +------------------------ | |
| 72 | + | |
| 73 | + :: | |
| 63 | 74 | |
| 64 | − Output example: | |
| 75 | + ethtool <ethX> | |
| 76 | + | |
| 77 | + Output example:: | |
| 65 | 78 | |
| 66 | 79 | Settings for enp1s0: |
| 67 | 80 | Supported ports: [ TP ] |
| 68 | 81 | Supported link modes: 100baseT/Full |
| 69 | − 1000baseT/Full | |
| 70 | − 10000baseT/Full | |
| 71 | − 2500baseT/Full | |
| 72 | − 5000baseT/Full | |
| 82 | + 1000baseT/Full | |
| 83 | + 10000baseT/Full | |
| 84 | + 2500baseT/Full | |
| 85 | + 5000baseT/Full | |
| 73 | 86 | Supported pause frame use: Symmetric |
| 74 | 87 | Supports auto-negotiation: Yes |
| 75 | 88 | Supported FEC modes: Not reported |
| 76 | 89 | Advertised link modes: 100baseT/Full |
| 77 | − 1000baseT/Full | |
| 78 | − 10000baseT/Full | |
| 79 | − 2500baseT/Full | |
| 80 | − 5000baseT/Full | |
| 90 | + 1000baseT/Full | |
| 91 | + 10000baseT/Full | |
| 92 | + 2500baseT/Full | |
| 93 | + 5000baseT/Full | |
| 81 | 94 | Advertised pause frame use: Symmetric |
| 82 | 95 | Advertised auto-negotiation: Yes |
| 83 | 96 | Advertised FEC modes: Not reported |
| @@ -92,16 +105,22 @@ Supported ethtool options · 8 unmodified lines | ||
| 92 | 105 | Wake-on: d |
| 93 | 106 | Link detected: yes |
| 94 | 107 | |
| 95 | − --- | |
| 96 | − Note: AQrate speeds (2.5/5 Gb/s) will be displayed only with linux kernels > 4.10. | |
| 97 | − But you can still use these speeds: | |
| 108 | + | |
| 109 | + .. note:: | |
| 110 | + | |
| 111 | + AQrate speeds (2.5/5 Gb/s) will be displayed only with linux kernels > 4.10. | |
| 112 | + But you can still use these speeds:: | |
| 113 | + | |
| 98 | 114 | ethtool -s eth0 autoneg off speed 2500 |
| 99 | 115 | |
| 100 | − Viewing adapter information | |
| 101 | − --------------------- | |
| 102 | − ethtool -i <ethX> | |
| 116 | +Viewing adapter information | |
| 117 | +--------------------------- | |
| 103 | 118 | |
| 104 | − Output example: | |
| 119 | + :: | |
| 120 | + | |
| 121 | + ethtool -i <ethX> | |
| 122 | + | |
| 123 | + Output example:: | |
| 105 | 124 | |
| 106 | 125 | driver: atlantic |
| 107 | 126 | version: 5.2.0-050200rc5-generic-kern |
| @@ -115,12 +134,16 @@ Supported ethtool options · 7 unmodified lines | ||
| 115 | 134 | supports-priv-flags: no |
| 116 | 135 | |
| 117 | 136 | |
| 118 | − Viewing Ethernet adapter statistics: | |
| 119 | − --------------------- | |
| 120 | − ethtool -S <ethX> | |
| 137 | +Viewing Ethernet adapter statistics | |
| 138 | +----------------------------------- | |
| 139 | + | |
| 140 | + :: | |
| 121 | 141 | |
| 122 | − Output example: | |
| 123 | − NIC statistics: | |
| 142 | + ethtool -S <ethX> | |
| 143 | + | |
| 144 | + Output example:: | |
| 145 | + | |
| 146 | + NIC statistics: | |
| 124 | 147 | InPackets: 13238607 |
| 125 | 148 | InUCast: 13293852 |
| 126 | 149 | InMCast: 52 |
| @@ -164,85 +187,95 @@ Supported ethtool options · 37 unmodified lines | ||
| 164 | 187 | Queue[3] InLroPackets: 0 |
| 165 | 188 | Queue[3] InErrors: 0 |
| 166 | 189 | |
| 167 | − Interrupt coalescing support | |
| 168 | − --------------------------------- | |
| 169 | − ITR mode, TX/RX coalescing timings could be viewed with: | |
| 190 | +Interrupt coalescing support | |
| 191 | +---------------------------- | |
| 170 | 192 | |
| 171 | − ethtool -c <ethX> | |
| 193 | + ITR mode, TX/RX coalescing timings could be viewed with:: | |
| 172 | 194 | |
| 173 | − and changed with: | |
| 195 | + ethtool -c <ethX> | |
| 174 | 196 | |
| 175 | − ethtool -C <ethX> tx-usecs <usecs> rx-usecs <usecs> | |
| 197 | + and changed with:: | |
| 176 | 198 | |
| 177 | − To disable coalescing: | |
| 199 | + ethtool -C <ethX> tx-usecs <usecs> rx-usecs <usecs> | |
| 178 | 200 | |
| 179 | − ethtool -C <ethX> tx-usecs 0 rx-usecs 0 tx-max-frames 1 tx-max-frames 1 | |
| 201 | + To disable coalescing:: | |
| 180 | 202 | |
| 181 | − Wake on LAN support | |
| 182 | − --------------------------------- | |
| 203 | + ethtool -C <ethX> tx-usecs 0 rx-usecs 0 tx-max-frames 1 tx-max-frames 1 | |
| 183 | 204 | |
| 184 | − WOL support by magic packet: | |
| 205 | +Wake on LAN support | |
| 206 | +------------------- | |
| 185 | 207 | |
| 186 | − ethtool -s <ethX> wol g | |
| 208 | + WOL support by magic packet:: | |
| 187 | 209 | |
| 188 | − To disable WOL: | |
| 210 | + ethtool -s <ethX> wol g | |
| 189 | 211 | |
| 190 | − ethtool -s <ethX> wol d | |
| 212 | + To disable WOL:: | |
| 191 | 213 | |
| 192 | − Set and check the driver message level | |
| 193 | − --------------------------------- | |
| 214 | + ethtool -s <ethX> wol d | |
| 215 | + | |
| 216 | +Set and check the driver message level | |
| 217 | +-------------------------------------- | |
| 194 | 218 | |
| 195 | 219 | Set message level |
| 196 | 220 | |
| 197 | − ethtool -s <ethX> msglvl <level> | |
| 221 | + :: | |
| 222 | + | |
| 223 | + ethtool -s <ethX> msglvl <level> | |
| 198 | 224 | |
| 199 | 225 | Level values: |
| 200 | 226 | |
| 201 | − 0x0001 - general driver status. | |
| 202 | − 0x0002 - hardware probing. | |
| 203 | − 0x0004 - link state. | |
| 204 | − 0x0008 - periodic status check. | |
| 205 | − 0x0010 - interface being brought down. | |
| 206 | − 0x0020 - interface being brought up. | |
| 207 | − 0x0040 - receive error. | |
| 208 | − 0x0080 - transmit error. | |
| 209 | − 0x0200 - interrupt handling. | |
| 210 | − 0x0400 - transmit completion. | |
| 211 | − 0x0800 - receive completion. | |
| 212 | − 0x1000 - packet contents. | |
| 213 | − 0x2000 - hardware status. | |
| 214 | − 0x4000 - Wake-on-LAN status. | |
| 227 | + ====== ============================= | |
| 228 | + 0x0001 general driver status. | |
| 229 | + 0x0002 hardware probing. | |
| 230 | + 0x0004 link state. | |
| 231 | + 0x0008 periodic status check. | |
| 232 | + 0x0010 interface being brought down. | |
| 233 | + 0x0020 interface being brought up. | |
| 234 | + 0x0040 receive error. | |
| 235 | + 0x0080 transmit error. | |
| 236 | + 0x0200 interrupt handling. | |
| 237 | + 0x0400 transmit completion. | |
| 238 | + 0x0800 receive completion. | |
| 239 | + 0x1000 packet contents. | |
| 240 | + 0x2000 hardware status. | |
| 241 | + 0x4000 Wake-on-LAN status. | |
| 242 | + ====== ============================= | |
| 215 | 243 | |
| 216 | 244 | By default, the level of debugging messages is set 0x0001(general driver status). |
| 217 | 245 | |
| 218 | 246 | Check message level |
| 219 | 247 | |
| 220 | − ethtool <ethX> | grep "Current message level" | |
| 248 | + :: | |
| 221 | 249 | |
| 222 | − If you want to disable the output of messages | |
| 250 | + ethtool <ethX> | grep "Current message level" | |
| 223 | 251 | |
| 224 | − ethtool -s <ethX> msglvl 0 | |
| 252 | + If you want to disable the output of messages:: | |
| 253 | + | |
| 254 | + ethtool -s <ethX> msglvl 0 | |
| 255 | + | |
| 256 | +RX flow rules (ntuple filters) | |
| 257 | +------------------------------ | |
| 225 | 258 | |
| 226 | − RX flow rules (ntuple filters) | |
| 227 | − --------------------------------- | |
| 228 | 259 | There are separate rules supported, that applies in that order: |
| 260 | + | |
| 229 | 261 | 1. 16 VLAN ID rules |
| 230 | 262 | 2. 16 L2 EtherType rules |
| 231 | 263 | 3. 8 L3/L4 5-Tuple rules |
| 232 | 264 | |
| 233 | 265 | |
| 234 | 266 | The driver utilizes the ethtool interface for configuring ntuple filters, |
| 235 | − via "ethtool -N <device> <filter>". | |
| 267 | + via ``ethtool -N <device> <filter>``. | |
| 236 | 268 | |
| 237 | − To enable or disable the RX flow rules: | |
| 269 | + To enable or disable the RX flow rules:: | |
| 238 | 270 | |
| 239 | − ethtool -K ethX ntuple <on|off> | |
| 271 | + ethtool -K ethX ntuple <on|off> | |
| 240 | 272 | |
| 241 | 273 | When disabling ntuple filters, all the user programed filters are |
| 242 | 274 | flushed from the driver cache and hardware. All needed filters must |
| 243 | 275 | be re-added when ntuple is re-enabled. |
| 244 | 276 | |
| 245 | 277 | Because of the fixed order of the rules, the location of filters is also fixed: |
| 278 | + | |
| 246 | 279 | - Locations 0 - 15 for VLAN ID filters |
| 247 | 280 | - Locations 16 - 31 for L2 EtherType filters |
| 248 | 281 | - Locations 32 - 39 for L3/L4 5-tuple filters (locations 32, 36 for IPv6) |
| @@ -253,32 +286,34 @@ Supported ethtool options · 4 unmodified lines | ||
| 253 | 286 | addresses can be supported. Source and destination ports are only compared for |
| 254 | 287 | TCP/UDP/SCTP packets. |
| 255 | 288 | |
| 256 | − To add a filter that directs packet to queue 5, use <-N|-U|--config-nfc|--config-ntuple> switch: | |
| 289 | + To add a filter that directs packet to queue 5, use | |
| 290 | + ``<-N|-U|--config-nfc|--config-ntuple>`` switch:: | |
| 257 | 291 | |
| 258 | − ethtool -N <ethX> flow-type udp4 src-ip 10.0.0.1 dst-ip 10.0.0.2 src-port 2000 dst-port 2001 action 5 <loc 32> | |
| 292 | + ethtool -N <ethX> flow-type udp4 src-ip 10.0.0.1 dst-ip 10.0.0.2 src-port 2000 dst-port 2001 action 5 <loc 32> | |
| 259 | 293 | |
| 260 | 294 | - action is the queue number. |
| 261 | 295 | - loc is the rule number. |
| 262 | 296 | |
| 263 | − For "flow-type ip4|udp4|tcp4|sctp4|ip6|udp6|tcp6|sctp6" you must set the loc | |
| 297 | + For ``flow-type ip4|udp4|tcp4|sctp4|ip6|udp6|tcp6|sctp6`` you must set the loc | |
| 264 | 298 | number within 32 - 39. |
| 265 | − For "flow-type ip4|udp4|tcp4|sctp4|ip6|udp6|tcp6|sctp6" you can set 8 rules | |
| 299 | + For ``flow-type ip4|udp4|tcp4|sctp4|ip6|udp6|tcp6|sctp6`` you can set 8 rules | |
| 266 | 300 | for traffic IPv4 or you can set 2 rules for traffic IPv6. Loc number traffic |
| 267 | 301 | IPv6 is 32 and 36. |
| 268 | 302 | At the moment you can not use IPv4 and IPv6 filters at the same time. |
| 269 | 303 | |
| 270 | − Example filter for IPv6 filter traffic: | |
| 304 | + Example filter for IPv6 filter traffic:: | |
| 271 | 305 | |
| 272 | − sudo ethtool -N <ethX> flow-type tcp6 src-ip 2001:db8:0:f101::1 dst-ip 2001:db8:0:f101::2 action 1 loc 32 | |
| 273 | − sudo ethtool -N <ethX> flow-type ip6 src-ip 2001:db8:0:f101::2 dst-ip 2001:db8:0:f101::5 action -1 loc 36 | |
| 306 | + sudo ethtool -N <ethX> flow-type tcp6 src-ip 2001:db8:0:f101::1 dst-ip 2001:db8:0:f101::2 action 1 loc 32 | |
| 307 | + sudo ethtool -N <ethX> flow-type ip6 src-ip 2001:db8:0:f101::2 dst-ip 2001:db8:0:f101::5 action -1 loc 36 | |
| 274 | 308 | |
| 275 | − Example filter for IPv4 filter traffic: | |
| 309 | + Example filter for IPv4 filter traffic:: | |
| 276 | 310 | |
| 277 | − sudo ethtool -N <ethX> flow-type udp4 src-ip 10.0.0.4 dst-ip 10.0.0.7 src-port 2000 dst-port 2001 loc 32 | |
| 278 | − sudo ethtool -N <ethX> flow-type tcp4 src-ip 10.0.0.3 dst-ip 10.0.0.9 src-port 2000 dst-port 2001 loc 33 | |
| 279 | − sudo ethtool -N <ethX> flow-type ip4 src-ip 10.0.0.6 dst-ip 10.0.0.4 loc 34 | |
| 311 | + sudo ethtool -N <ethX> flow-type udp4 src-ip 10.0.0.4 dst-ip 10.0.0.7 src-port 2000 dst-port 2001 loc 32 | |
| 312 | + sudo ethtool -N <ethX> flow-type tcp4 src-ip 10.0.0.3 dst-ip 10.0.0.9 src-port 2000 dst-port 2001 loc 33 | |
| 313 | + sudo ethtool -N <ethX> flow-type ip4 src-ip 10.0.0.6 dst-ip 10.0.0.4 loc 34 | |
| 280 | 314 | |
| 281 | 315 | If you set action -1, then all traffic corresponding to the filter will be discarded. |
| 316 | + | |
| 282 | 317 | The maximum value action is 31. |
| 283 | 318 | |
| 284 | 319 | |
| @@ -287,8 +322,9 @@ Supported ethtool options · 2 unmodified lines | ||
| 287 | 322 | from L2 Ethertype filter with UserPriority since both User Priority and VLAN ID |
| 288 | 323 | are passed in the same 'vlan' parameter. |
| 289 | 324 | |
| 290 | − To add a filter that directs packets from VLAN 2001 to queue 5: | |
| 291 | − ethtool -N <ethX> flow-type ip4 vlan 2001 m 0xF000 action 1 loc 0 | |
| 325 | + To add a filter that directs packets from VLAN 2001 to queue 5:: | |
| 326 | + | |
| 327 | + ethtool -N <ethX> flow-type ip4 vlan 2001 m 0xF000 action 1 loc 0 | |
| 292 | 328 | |
| 293 | 329 | |
| 294 | 330 | L2 EtherType filters allows filter packet by EtherType field or both EtherType |
| @@ -297,17 +333,17 @@ Supported ethtool options · 2 unmodified lines | ||
| 297 | 333 | distinguish VLAN filter from L2 Ethertype filter with UserPriority since both |
| 298 | 334 | User Priority and VLAN ID are passed in the same 'vlan' parameter. |
| 299 | 335 | |
| 300 | − To add a filter that directs IP4 packess of priority 3 to queue 3: | |
| 301 | − ethtool -N <ethX> flow-type ether proto 0x800 vlan 0x600 m 0x1FFF action 3 loc 16 | |
| 336 | + To add a filter that directs IP4 packess of priority 3 to queue 3:: | |
| 302 | 337 | |
| 338 | + ethtool -N <ethX> flow-type ether proto 0x800 vlan 0x600 m 0x1FFF action 3 loc 16 | |
| 303 | 339 | |
| 304 | − To see the list of filters currently present: | |
| 340 | + To see the list of filters currently present:: | |
| 305 | 341 | |
| 306 | − ethtool <-u|-n|--show-nfc|--show-ntuple> <ethX> | |
| 342 | + ethtool <-u|-n|--show-nfc|--show-ntuple> <ethX> | |
| 307 | 343 | |
| 308 | − Rules may be deleted from the table itself. This is done using: | |
| 344 | + Rules may be deleted from the table itself. This is done using:: | |
| 309 | 345 | |
| 310 | − sudo ethtool <-N|-U|--config-nfc|--config-ntuple> <ethX> delete <loc> | |
| 346 | + sudo ethtool <-N|-U|--config-nfc|--config-ntuple> <ethX> delete <loc> | |
| 311 | 347 | |
| 312 | 348 | - loc is the rule number to be deleted. |
| 313 | 349 | |
| @@ -316,34 +352,37 @@ Supported ethtool options · 2 unmodified lines | ||
| 316 | 352 | case, any flow that matches the filter criteria will be directed to the |
| 317 | 353 | appropriate queue. RX filters is supported on all kernels 2.6.30 and later. |
| 318 | 354 | |
| 319 | − RSS for UDP | |
| 320 | − --------------------------------- | |
| 355 | +RSS for UDP | |
| 356 | +----------- | |
| 357 | + | |
| 321 | 358 | Currently, NIC does not support RSS for fragmented IP packets, which leads to |
| 322 | 359 | incorrect working of RSS for fragmented UDP traffic. To disable RSS for UDP the |
| 323 | 360 | RX Flow L3/L4 rule may be used. |
| 324 | 361 | |
| 325 | − Example: | |
| 326 | − ethtool -N eth0 flow-type udp4 action 0 loc 32 | |
| 362 | + Example:: | |
| 363 | + | |
| 364 | + ethtool -N eth0 flow-type udp4 action 0 loc 32 | |
| 365 | + | |
| 366 | +UDP GSO hardware offload | |
| 367 | +------------------------ | |
| 327 | 368 | |
| 328 | − UDP GSO hardware offload | |
| 329 | − --------------------------------- | |
| 330 | 369 | UDP GSO allows to boost UDP tx rates by offloading UDP headers allocation |
| 331 | 370 | into hardware. A special userspace socket option is required for this, |
| 332 | − could be validated with /kernel/tools/testing/selftests/net/ | |
| 371 | + could be validated with /kernel/tools/testing/selftests/net/:: | |
| 333 | 372 | |
| 334 | 373 | udpgso_bench_tx -u -4 -D 10.0.1.1 -s 6300 -S 100 |
| 335 | 374 | |
| 336 | 375 | Will cause sending out of 100 byte sized UDP packets formed from single |
| 337 | 376 | 6300 bytes user buffer. |
| 338 | 377 | |
| 339 | − UDP GSO is configured by: | |
| 378 | + UDP GSO is configured by:: | |
| 340 | 379 | |
| 341 | 380 | ethtool -K eth0 tx-udp-segmentation on |
| 342 | 381 | |
| 343 | − Private flags (testing) | |
| 344 | − --------------------------------- | |
| 382 | +Private flags (testing) | |
| 383 | +----------------------- | |
| 345 | 384 | |
| 346 | − Atlantic driver supports private flags for hardware custom features: | |
| 385 | + Atlantic driver supports private flags for hardware custom features:: | |
| 347 | 386 | |
| 348 | 387 | $ ethtool --show-priv-flags ethX |
| 349 | 388 | |
| @@ -354,7 +393,7 @@ Supported ethtool options · 4 unmodified lines | ||
| 354 | 393 | PHYInternalLoopback: off |
| 355 | 394 | PHYExternalLoopback: off |
| 356 | 395 | |
| 357 | − Example: | |
| 396 | + Example:: | |
| 358 | 397 | |
| 359 | 398 | $ ethtool --set-priv-flags ethX DMASystemLoopback on |
| 360 | 399 | |
| @@ -370,93 +409,130 @@ Command Line Parameters · 9 unmodified lines | ||
| 370 | 409 | The following command line parameters are available on atlantic driver: |
| 371 | 410 | |
| 372 | 411 | aq_itr -Interrupt throttling mode |
| 373 | −---------------------------------------- | |
| 412 | +--------------------------------- | |
| 374 | 413 | Accepted values: 0, 1, 0xFFFF |
| 414 | + | |
| 375 | 415 | Default value: 0xFFFF |
| 376 | −0 - Disable interrupt throttling. | |
| 377 | −1 - Enable interrupt throttling and use specified tx and rx rates. | |
| 378 | −0xFFFF - Auto throttling mode. Driver will choose the best RX and TX | |
| 379 | − interrupt throtting settings based on link speed. | |
| 416 | + | |
| 417 | +====== ============================================================== | |
| 418 | +0 Disable interrupt throttling. | |
| 419 | +1 Enable interrupt throttling and use specified tx and rx rates. | |
| 420 | +0xFFFF Auto throttling mode. Driver will choose the best RX and TX | |
| 421 | + interrupt throtting settings based on link speed. | |
| 422 | +====== ============================================================== | |
| 380 | 423 | |
| 381 | 424 | aq_itr_tx - TX interrupt throttle rate |
| 382 | −---------------------------------------- | |
| 425 | +-------------------------------------- | |
| 426 | + | |
| 383 | 427 | Accepted values: 0 - 0x1FF |
| 428 | + | |
| 384 | 429 | Default value: 0 |
| 430 | + | |
| 385 | 431 | TX side throttling in microseconds. Adapter will setup maximum interrupt delay |
| 386 | 432 | to this value. Minimum interrupt delay will be a half of this value |
| 387 | 433 | |
| 388 | 434 | aq_itr_rx - RX interrupt throttle rate |
| 389 | −---------------------------------------- | |
| 435 | +-------------------------------------- | |
| 436 | + | |
| 390 | 437 | Accepted values: 0 - 0x1FF |
| 438 | + | |
| 391 | 439 | Default value: 0 |
| 440 | + | |
| 392 | 441 | RX side throttling in microseconds. Adapter will setup maximum interrupt delay |
| 393 | 442 | to this value. Minimum interrupt delay will be a half of this value |
| 394 | 443 | |
| 395 | −Note: ITR settings could be changed in runtime by ethtool -c means (see below) | |
| 444 | +.. note:: | |
| 445 | + | |
| 446 | + ITR settings could be changed in runtime by ethtool -c means (see below) | |
| 396 | 447 | |
| 397 | 448 | Config file parameters |
| 398 | −======================= | |
| 449 | +====================== | |
| 450 | + | |
| 399 | 451 | For some fine tuning and performance optimizations, |
| 400 | 452 | some parameters can be changed in the {source_dir}/aq_cfg.h file. |
| 401 | 453 | |
| 402 | 454 | AQ_CFG_RX_PAGEORDER |
| 403 | −---------------------------------------- | |
| 455 | +------------------- | |
| 456 | + | |
| 404 | 457 | Default value: 0 |
| 458 | + | |
| 405 | 459 | RX page order override. Thats a power of 2 number of RX pages allocated for |
| 406 | −each descriptor. Received descriptor size is still limited by AQ_CFG_RX_FRAME_MAX. | |
| 460 | +each descriptor. Received descriptor size is still limited by | |
| 461 | +AQ_CFG_RX_FRAME_MAX. | |
| 462 | + | |
| 407 | 463 | Increasing pageorder makes page reuse better (actual on iommu enabled systems). |
| 408 | 464 | |
| 409 | 465 | AQ_CFG_RX_REFILL_THRES |
| 410 | −---------------------------------------- | |
| 466 | +---------------------- | |
| 467 | + | |
| 411 | 468 | Default value: 32 |
| 469 | + | |
| 412 | 470 | RX refill threshold. RX path will not refill freed descriptors until the |
| 413 | 471 | specified number of free descriptors is observed. Larger values may help |
| 414 | 472 | better page reuse but may lead to packet drops as well. |
| 415 | 473 | |
| 416 | 474 | AQ_CFG_VECS_DEF |
| 417 | −------------------------------------------------------------ | |
| 475 | +--------------- | |
| 476 | + | |
| 418 | 477 | Number of queues |
| 478 | + | |
| 419 | 479 | Valid Range: 0 - 8 (up to AQ_CFG_VECS_MAX) |
| 480 | + | |
| 420 | 481 | Default value: 8 |
| 482 | + | |
| 421 | 483 | Notice this value will be capped by the number of cores available on the system. |
| 422 | 484 | |
| 423 | 485 | AQ_CFG_IS_RSS_DEF |
| 424 | −------------------------------------------------------------ | |
| 486 | +----------------- | |
| 487 | + | |
| 425 | 488 | Enable/disable Receive Side Scaling |
| 426 | 489 | |
| 427 | 490 | This feature allows the adapter to distribute receive processing |
| 428 | 491 | across multiple CPU-cores and to prevent from overloading a single CPU core. |
| 429 | 492 | |
| 430 | 493 | Valid values |
| 431 | −0 - disabled | |
| 432 | −1 - enabled | |
| 494 | + | |
| 495 | +== ======== | |
| 496 | +0 disabled | |
| 497 | +1 enabled | |
| 498 | +== ======== | |
| 433 | 499 | |
| 434 | 500 | Default value: 1 |
| 435 | 501 | |
| 436 | 502 | AQ_CFG_NUM_RSS_QUEUES_DEF |
| 437 | −------------------------------------------------------------ | |
| 503 | +------------------------- | |
| 504 | + | |
| 438 | 505 | Number of queues for Receive Side Scaling |
| 506 | + | |
| 439 | 507 | Valid Range: 0 - 8 (up to AQ_CFG_VECS_DEF) |
| 440 | 508 | |
| 441 | 509 | Default value: AQ_CFG_VECS_DEF |
| 442 | 510 | |
| 443 | 511 | AQ_CFG_IS_LRO_DEF |
| 444 | −------------------------------------------------------------ | |
| 512 | +----------------- | |
| 513 | + | |
| 445 | 514 | Enable/disable Large Receive Offload |
| 446 | 515 | |
| 447 | 516 | This offload enables the adapter to coalesce multiple TCP segments and indicate |
| 448 | 517 | them as a single coalesced unit to the OS networking subsystem. |
| 449 | −The system consumes less energy but it also introduces more latency in packets processing. | |
| 518 | + | |
| 519 | +The system consumes less energy but it also introduces more latency in packets | |
| 520 | +processing. | |
| 450 | 521 | |
| 451 | 522 | Valid values |
| 452 | −0 - disabled | |
| 453 | −1 - enabled | |
| 523 | + | |
| 524 | +== ======== | |
| 525 | +0 disabled | |
| 526 | +1 enabled | |
| 527 | +== ======== | |
| 454 | 528 | |
| 455 | 529 | Default value: 1 |
| 456 | 530 | |
| 457 | 531 | AQ_CFG_TX_CLEAN_BUDGET |
| 458 | −---------------------------------------- | |
| 532 | +---------------------- | |
| 533 | + | |
| 459 | 534 | Maximum descriptors to cleanup on TX at once. |
| 535 | + | |
| 460 | 536 | Default value: 256 |
| 461 | 537 | |
| 462 | 538 | After the aq_cfg.h file changed the driver must be rebuilt to take effect. |
| @@ -472,7 +548,8 @@ License · 9 unmodified lines | ||
| 472 | 548 | ======= |
| 473 | 549 | |
| 474 | 550 | aQuantia Corporation Network Driver |
| 475 | −Copyright(c) 2014 - 2019 aQuantia Corporation. | |
| 551 | + | |
| 552 | +Copyright |copy| 2014 - 2019 aQuantia Corporation. | |
| 476 | 553 | |
| 477 | 554 | This program is free software; you can redistribute it and/or modify it |
| 478 | 555 | under the terms and conditions of the GNU General Public License, |
| @@ -1,13 +1,18 @@ | ||
| 1 | − Chelsio N210 10Gb Ethernet Network Controller | |
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | +.. include:: <isonum.txt> | |
| 2 | 3 | |
| 3 | − Driver Release Notes for Linux | |
| 4 | +============================================= | |
| 5 | +Chelsio N210 10Gb Ethernet Network Controller | |
| 6 | +============================================= | |
| 4 | 7 | |
| 5 | − Version 2.1.1 | |
| 8 | +Driver Release Notes for Linux | |
| 6 | 9 | |
| 7 | − June 20, 2005 | |
| 10 | +Version 2.1.1 | |
| 11 | + | |
| 12 | +June 20, 2005 | |
| 13 | + | |
| 14 | +.. Contents | |
| 8 | 15 | |
| 9 | −CONTENTS | |
| 10 | −======== | |
| 11 | 16 | INTRODUCTION |
| 12 | 17 | FEATURES |
| 13 | 18 | PERFORMANCE |
| @@ -16,7 +21,7 @@ CONTENTS · 2 unmodified lines | ||
| 16 | 21 | SUPPORT |
| 17 | 22 | |
| 18 | 23 | |
| 19 | −INTRODUCTION | |
| 24 | +Introduction | |
| 20 | 25 | ============ |
| 21 | 26 | |
| 22 | 27 | This document describes the Linux driver for Chelsio 10Gb Ethernet Network |
| @@ -24,11 +29,11 @@ INTRODUCTION · 1 unmodified line | ||
| 24 | 29 | compatible with the Chelsio N110 model 10Gb NICs. |
| 25 | 30 | |
| 26 | 31 | |
| 27 | −FEATURES | |
| 32 | +Features | |
| 28 | 33 | ======== |
| 29 | 34 | |
| 30 | − Adaptive Interrupts (adaptive-rx) | |
| 31 | − --------------------------------- | |
| 35 | +Adaptive Interrupts (adaptive-rx) | |
| 36 | +--------------------------------- | |
| 32 | 37 | |
| 33 | 38 | This feature provides an adaptive algorithm that adjusts the interrupt |
| 34 | 39 | coalescing parameters, allowing the driver to dynamically adapt the latency |
| @@ -39,24 +44,24 @@ FEATURES · 4 unmodified lines | ||
| 39 | 44 | ethtool manpage for additional usage information. |
| 40 | 45 | |
| 41 | 46 | By default, adaptive-rx is disabled. |
| 42 | − To enable adaptive-rx: | |
| 47 | + To enable adaptive-rx:: | |
| 43 | 48 | |
| 44 | 49 | ethtool -C <interface> adaptive-rx on |
| 45 | 50 | |
| 46 | − To disable adaptive-rx, use ethtool: | |
| 51 | + To disable adaptive-rx, use ethtool:: | |
| 47 | 52 | |
| 48 | 53 | ethtool -C <interface> adaptive-rx off |
| 49 | 54 | |
| 50 | 55 | After disabling adaptive-rx, the timer latency value will be set to 50us. |
| 51 | − You may set the timer latency after disabling adaptive-rx: | |
| 56 | + You may set the timer latency after disabling adaptive-rx:: | |
| 52 | 57 | |
| 53 | 58 | ethtool -C <interface> rx-usecs <microseconds> |
| 54 | 59 | |
| 55 | − An example to set the timer latency value to 100us on eth0: | |
| 60 | + An example to set the timer latency value to 100us on eth0:: | |
| 56 | 61 | |
| 57 | 62 | ethtool -C eth0 rx-usecs 100 |
| 58 | 63 | |
| 59 | − You may also provide a timer latency value while disabling adaptive-rx: | |
| 64 | + You may also provide a timer latency value while disabling adaptive-rx:: | |
| 60 | 65 | |
| 61 | 66 | ethtool -C <interface> adaptive-rx off rx-usecs <microseconds> |
| 62 | 67 | |
| @@ -64,13 +69,13 @@ FEATURES · 1 unmodified line | ||
| 64 | 69 | will be set to the specified value until changed by the user or until |
| 65 | 70 | adaptive-rx is enabled. |
| 66 | 71 | |
| 67 | − To view the status of the adaptive-rx and timer latency values: | |
| 72 | + To view the status of the adaptive-rx and timer latency values:: | |
| 68 | 73 | |
| 69 | 74 | ethtool -c <interface> |
| 70 | 75 | |
| 71 | 76 | |
| 72 | − TCP Segmentation Offloading (TSO) Support | |
| 73 | − ----------------------------------------- | |
| 77 | +TCP Segmentation Offloading (TSO) Support | |
| 78 | +----------------------------------------- | |
| 74 | 79 | |
| 75 | 80 | This feature, also known as "large send", enables a system's protocol stack |
| 76 | 81 | to offload portions of outbound TCP processing to a network interface card |
| @@ -80,20 +85,20 @@ FEATURES · 3 unmodified lines | ||
| 80 | 85 | Please see the ethtool manpage for additional usage information. |
| 81 | 86 | |
| 82 | 87 | By default, TSO is enabled. |
| 83 | − To disable TSO: | |
| 88 | + To disable TSO:: | |
| 84 | 89 | |
| 85 | 90 | ethtool -K <interface> tso off |
| 86 | 91 | |
| 87 | − To enable TSO: | |
| 92 | + To enable TSO:: | |
| 88 | 93 | |
| 89 | 94 | ethtool -K <interface> tso on |
| 90 | 95 | |
| 91 | − To view the status of TSO: | |
| 96 | + To view the status of TSO:: | |
| 92 | 97 | |
| 93 | 98 | ethtool -k <interface> |
| 94 | 99 | |
| 95 | 100 | |
| 96 | −PERFORMANCE | |
| 101 | +Performance | |
| 97 | 102 | =========== |
| 98 | 103 | |
| 99 | 104 | The following information is provided as an example of how to change system |
| @@ -111,59 +116,81 @@ PERFORMANCE · 11 unmodified lines | ||
| 111 | 116 | your system. You may want to write a script that runs at boot-up which |
| 112 | 117 | includes the optimal settings for your system. |
| 113 | 118 | |
| 114 | − Setting PCI Latency Timer: | |
| 115 | − setpci -d 1425:* 0x0c.l=0x0000F800 | |
| 119 | + Setting PCI Latency Timer:: | |
| 120 | + | |
| 121 | + setpci -d 1425:: | |
| 122 | + | |
| 123 | +* 0x0c.l=0x0000F800 | |
| 124 | + | |
| 125 | + Disabling TCP timestamp:: | |
| 116 | 126 | |
| 117 | − Disabling TCP timestamp: | |
| 118 | 127 | sysctl -w net.ipv4.tcp_timestamps=0 |
| 119 | 128 | |
| 120 | − Disabling SACK: | |
| 129 | + Disabling SACK:: | |
| 130 | + | |
| 121 | 131 | sysctl -w net.ipv4.tcp_sack=0 |
| 122 | 132 | |
| 123 | − Setting large number of incoming connection requests: | |
| 133 | + Setting large number of incoming connection requests:: | |
| 134 | + | |
| 124 | 135 | sysctl -w net.ipv4.tcp_max_syn_backlog=3000 |
| 125 | 136 | |
| 126 | − Setting maximum receive socket buffer size: | |
| 137 | + Setting maximum receive socket buffer size:: | |
| 138 | + | |
| 127 | 139 | sysctl -w net.core.rmem_max=1024000 |
| 128 | 140 | |
| 129 | − Setting maximum send socket buffer size: | |
| 141 | + Setting maximum send socket buffer size:: | |
| 142 | + | |
| 130 | 143 | sysctl -w net.core.wmem_max=1024000 |
| 131 | 144 | |
| 132 | − Set smp_affinity (on a multiprocessor system) to a single CPU: | |
| 145 | + Set smp_affinity (on a multiprocessor system) to a single CPU:: | |
| 146 | + | |
| 133 | 147 | echo 1 > /proc/irq/<interrupt_number>/smp_affinity |
| 134 | 148 | |
| 135 | − Setting default receive socket buffer size: | |
| 149 | + Setting default receive socket buffer size:: | |
| 150 | + | |
| 136 | 151 | sysctl -w net.core.rmem_default=524287 |
| 137 | 152 | |
| 138 | − Setting default send socket buffer size: | |
| 153 | + Setting default send socket buffer size:: | |
| 154 | + | |
| 139 | 155 | sysctl -w net.core.wmem_default=524287 |
| 140 | 156 | |
| 141 | − Setting maximum option memory buffers: | |
| 157 | + Setting maximum option memory buffers:: | |
| 158 | + | |
| 142 | 159 | sysctl -w net.core.optmem_max=524287 |
| 143 | 160 | |
| 144 | − Setting maximum backlog (# of unprocessed packets before kernel drops): | |
| 161 | + Setting maximum backlog (# of unprocessed packets before kernel drops):: | |
| 162 | + | |
| 145 | 163 | sysctl -w net.core.netdev_max_backlog=300000 |
| 146 | 164 | |
| 147 | − Setting TCP read buffers (min/default/max): | |
| 165 | + Setting TCP read buffers (min/default/max):: | |
| 166 | + | |
| 148 | 167 | sysctl -w net.ipv4.tcp_rmem="10000000 10000000 10000000" |
| 149 | 168 | |
| 150 | − Setting TCP write buffers (min/pressure/max): | |
| 169 | + Setting TCP write buffers (min/pressure/max):: | |
| 170 | + | |
| 151 | 171 | sysctl -w net.ipv4.tcp_wmem="10000000 10000000 10000000" |
| 152 | 172 | |
| 153 | − Setting TCP buffer space (min/pressure/max): | |
| 173 | + Setting TCP buffer space (min/pressure/max):: | |
| 174 | + | |
| 154 | 175 | sysctl -w net.ipv4.tcp_mem="10000000 10000000 10000000" |
| 155 | 176 | |
| 156 | 177 | TCP window size for single connections: |
| 178 | + | |
| 157 | 179 | The receive buffer (RX_WINDOW) size must be at least as large as the |
| 158 | 180 | Bandwidth-Delay Product of the communication link between the sender and |
| 159 | 181 | receiver. Due to the variations of RTT, you may want to increase the buffer |
| 160 | 182 | size up to 2 times the Bandwidth-Delay Product. Reference page 289 of |
| 161 | 183 | "TCP/IP Illustrated, Volume 1, The Protocols" by W. Richard Stevens. |
| 162 | − At 10Gb speeds, use the following formula: | |
| 184 | + | |
| 185 | + At 10Gb speeds, use the following formula:: | |
| 186 | + | |
| 163 | 187 | RX_WINDOW >= 1.25MBytes * RTT(in milliseconds) |
| 164 | 188 | Example for RTT with 100us: RX_WINDOW = (1,250,000 * 0.1) = 125,000 |
| 189 | + | |
| 165 | 190 | RX_WINDOW sizes of 256KB - 512KB should be sufficient. |
| 166 | − Setting the min, max, and default receive buffer (RX_WINDOW) size: | |
| 191 | + | |
| 192 | + Setting the min, max, and default receive buffer (RX_WINDOW) size:: | |
| 193 | + | |
| 167 | 194 | sysctl -w net.ipv4.tcp_rmem="<min> <default> <max>" |
| 168 | 195 | |
| 169 | 196 | TCP window size for multiple connections: |
| @@ -174,30 +201,35 @@ PERFORMANCE · 4 unmodified lines | ||
| 174 | 201 | not supported on the machine. Experimentation may be necessary to attain |
| 175 | 202 | the correct value. This method is provided as a starting point for the |
| 176 | 203 | correct receive buffer size. |
| 204 | + | |
| 177 | 205 | Setting the min, max, and default receive buffer (RX_WINDOW) size is |
| 178 | 206 | performed in the same manner as single connection. |
| 179 | 207 | |
| 180 | 208 | |
| 181 | −DRIVER MESSAGES | |
| 209 | +Driver Messages | |
| 182 | 210 | =============== |
| 183 | 211 | |
| 184 | 212 | The following messages are the most common messages logged by syslog. These |
| 185 | 213 | may be found in /var/log/messages. |
| 186 | 214 | |
| 187 | − Driver up: | |
| 215 | + Driver up:: | |
| 216 | + | |
| 188 | 217 | Chelsio Network Driver - version 2.1.1 |
| 189 | 218 | |
| 190 | − NIC detected: | |
| 219 | + NIC detected:: | |
| 220 | + | |
| 191 | 221 | eth#: Chelsio N210 1x10GBaseX NIC (rev #), PCIX 133MHz/64-bit |
| 192 | 222 | |
| 193 | − Link up: | |
| 223 | + Link up:: | |
| 224 | + | |
| 194 | 225 | eth#: link is up at 10 Gbps, full duplex |
| 195 | 226 | |
| 196 | − Link down: | |
| 227 | + Link down:: | |
| 228 | + | |
| 197 | 229 | eth#: link is down |
| 198 | 230 | |
| 199 | 231 | |
| 200 | −KNOWN ISSUES | |
| 232 | +Known Issues | |
| 201 | 233 | ============ |
| 202 | 234 | |
| 203 | 235 | These issues have been identified during testing. The following information |
| @@ -214,27 +246,33 @@ KNOWN ISSUES · 10 unmodified lines | ||
| 214 | 246 | |
| 215 | 247 | To eliminate the TCP retransmits, set smp_affinity on the particular |
| 216 | 248 | interrupt to a single CPU. You can locate the interrupt (IRQ) used on |
| 217 | − the N110/N210 by using ifconfig: | |
| 218 | − ifconfig <dev_name> | grep Interrupt | |
| 219 | − Set the smp_affinity to a single CPU: | |
| 220 | − echo 1 > /proc/irq/<interrupt_number>/smp_affinity | |
| 249 | + the N110/N210 by using ifconfig:: | |
| 250 | + | |
| 251 | + ifconfig <dev_name> | grep Interrupt | |
| 252 | + | |
| 253 | + Set the smp_affinity to a single CPU:: | |
| 254 | + | |
| 255 | + echo 1 > /proc/irq/<interrupt_number>/smp_affinity | |
| 221 | 256 | |
| 222 | 257 | It is highly suggested that you do not run the irqbalance daemon on your |
| 223 | 258 | system, as this will change any smp_affinity setting you have applied. |
| 224 | 259 | The irqbalance daemon runs on a 10 second interval and binds interrupts |
| 225 | − to the least loaded CPU determined by the daemon. To disable this daemon: | |
| 226 | − chkconfig --level 2345 irqbalance off | |
| 260 | + to the least loaded CPU determined by the daemon. To disable this daemon:: | |
| 261 | + | |
| 262 | + chkconfig --level 2345 irqbalance off | |
| 227 | 263 | |
| 228 | 264 | By default, some Linux distributions enable the kernel feature, |
| 229 | 265 | irqbalance, which performs the same function as the daemon. To disable |
| 230 | − this feature, add the following line to your bootloader: | |
| 231 | − noirqbalance | |
| 266 | + this feature, add the following line to your bootloader:: | |
| 267 | + | |
| 268 | + noirqbalance | |
| 269 | + | |
| 270 | + Example using the Grub bootloader:: | |
| 232 | 271 | |
| 233 | − Example using the Grub bootloader: | |
| 234 | − title Red Hat Enterprise Linux AS (2.4.21-27.ELsmp) | |
| 235 | − root (hd0,0) | |
| 236 | − kernel /vmlinuz-2.4.21-27.ELsmp ro root=/dev/hda3 noirqbalance | |
| 237 | − initrd /initrd-2.4.21-27.ELsmp.img | |
| 272 | + title Red Hat Enterprise Linux AS (2.4.21-27.ELsmp) | |
| 273 | + root (hd0,0) | |
| 274 | + kernel /vmlinuz-2.4.21-27.ELsmp ro root=/dev/hda3 noirqbalance | |
| 275 | + initrd /initrd-2.4.21-27.ELsmp.img | |
| 238 | 276 | |
| 239 | 277 | 2. After running insmod, the driver is loaded and the incorrect network |
| 240 | 278 | interface is brought up without running ifup. |
| @@ -277,12 +315,13 @@ KNOWN ISSUES · 36 unmodified lines | ||
| 277 | 315 | AMD's provides three workarounds for this problem, however, Chelsio |
| 278 | 316 | recommends the first option for best performance with this bug: |
| 279 | 317 | |
| 280 | − For 133Mhz secondary bus operation, limit the transaction length and | |
| 281 | − the number of outstanding transactions, via BIOS configuration | |
| 282 | − programming of the PCI-X card, to the following: | |
| 318 | + For 133Mhz secondary bus operation, limit the transaction length and | |
| 319 | + the number of outstanding transactions, via BIOS configuration | |
| 320 | + programming of the PCI-X card, to the following: | |
| 283 | 321 | |
| 284 | − Data Length (bytes): 1k | |
| 285 | − Total allowed outstanding transactions: 2 | |
| 322 | + Data Length (bytes): 1k | |
| 323 | + | |
| 324 | + Total allowed outstanding transactions: 2 | |
| 286 | 325 | |
| 287 | 326 | Please refer to AMD 8131-HT/PCI-X Errata 26310 Rev 3.08 August 2004, |
| 288 | 327 | section 56, "133-MHz Mode Split Completion Data Corruption" for more |
| @@ -293,8 +332,10 @@ KNOWN ISSUES · 4 unmodified lines | ||
| 293 | 332 | have issues with these settings, please revert to the "safe" settings |
| 294 | 333 | and duplicate the problem before submitting a bug or asking for support. |
| 295 | 334 | |
| 296 | − NOTE: The default setting on most systems is 8 outstanding transactions | |
| 297 | − and 2k bytes data length. | |
| 335 | + .. note:: | |
| 336 | + | |
| 337 | + The default setting on most systems is 8 outstanding transactions | |
| 338 | + and 2k bytes data length. | |
| 298 | 339 | |
| 299 | 340 | 4. On multiprocessor systems, it has been noted that an application which |
| 300 | 341 | is handling 10Gb networking can switch between CPUs causing degraded |
| @@ -320,14 +361,16 @@ KNOWN ISSUES · 19 unmodified lines | ||
| 320 | 361 | particular CPU: runon 0 ifup eth0 |
| 321 | 362 | |
| 322 | 363 | |
| 323 | −SUPPORT | |
| 364 | +Support | |
| 324 | 365 | ======= |
| 325 | 366 | |
| 326 | 367 | If you have problems with the software or hardware, please contact our |
| 327 | 368 | customer support team via email at support@chelsio.com or check our website |
| 328 | 369 | at http://www.chelsio.com |
| 329 | 370 | |
| 330 | −=============================================================================== | |
| 371 | +------------------------------------------------------------------------------- | |
| 372 | + | |
| 373 | +:: | |
| 331 | 374 | |
| 332 | 375 | Chelsio Communications |
| 333 | 376 | 370 San Aleso Ave. |
| @@ -343,10 +386,8 @@ You should have received a copy of the GNU General Public License along · 9 unmodified lines | ||
| 343 | 386 | with this program; if not, write to the Free Software Foundation, Inc., |
| 344 | 387 | 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. |
| 345 | 388 | |
| 346 | −THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED | |
| 389 | +THIS SOFTWARE IS PROVIDED ``AS IS`` AND WITHOUT ANY EXPRESS OR IMPLIED | |
| 347 | 390 | WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF |
| 348 | 391 | MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. |
| 349 | 392 | |
| 350 | − Copyright (c) 2003-2005 Chelsio Communications. All rights reserved. | |
| 351 | − | |
| 352 | −=============================================================================== | |
| 393 | +Copyright |copy| 2003-2005 Chelsio Communications. All rights reserved. | |
| @@ -1,79 +1,84 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 1 | 2 | |
| 2 | −NOTE | |
| 3 | −---- | |
| 3 | +================================================ | |
| 4 | +Cirrus Logic LAN CS8900/CS8920 Ethernet Adapters | |
| 5 | +================================================ | |
| 4 | 6 | |
| 5 | −This document was contributed by Cirrus Logic for kernel 2.2.5. This version | |
| 6 | −has been updated for 2.3.48 by Andrew Morton. | |
| 7 | +.. note:: | |
| 8 | + | |
| 9 | + This document was contributed by Cirrus Logic for kernel 2.2.5. This version | |
| 10 | + has been updated for 2.3.48 by Andrew Morton. | |
| 11 | + | |
| 12 | + Still, this is too outdated! A major cleanup is needed here. | |
| 7 | 13 | |
| 8 | 14 | Cirrus make a copy of this driver available at their website, as |
| 9 | 15 | described below. In general, you should use the driver version which |
| 10 | 16 | comes with your Linux distribution. |
| 11 | 17 | |
| 12 | 18 | |
| 13 | − | |
| 14 | −CIRRUS LOGIC LAN CS8900/CS8920 ETHERNET ADAPTERS | |
| 15 | 19 | Linux Network Interface Driver ver. 2.00 <kernel 2.3.48> |
| 16 | −=============================================================================== | |
| 17 | − | |
| 18 | − | |
| 19 | −TABLE OF CONTENTS | |
| 20 | − | |
| 21 | −1.0 CIRRUS LOGIC LAN CS8900/CS8920 ETHERNET ADAPTERS | |
| 22 | − 1.1 Product Overview | |
| 23 | − 1.2 Driver Description | |
| 24 | − 1.2.1 Driver Name | |
| 25 | − 1.2.2 File in the Driver Package | |
| 26 | − 1.3 System Requirements | |
| 27 | − 1.4 Licensing Information | |
| 28 | − | |
| 29 | −2.0 ADAPTER INSTALLATION and CONFIGURATION | |
| 30 | − 2.1 CS8900-based Adapter Configuration | |
| 31 | − 2.2 CS8920-based Adapter Configuration | |
| 32 | − | |
| 33 | −3.0 LOADING THE DRIVER AS A MODULE | |
| 34 | − | |
| 35 | −4.0 COMPILING THE DRIVER | |
| 36 | − 4.1 Compiling the Driver as a Loadable Module | |
| 37 | − 4.2 Compiling the driver to support memory mode | |
| 38 | − 4.3 Compiling the driver to support Rx DMA | |
| 39 | − | |
| 40 | −5.0 TESTING AND TROUBLESHOOTING | |
| 41 | − 5.1 Known Defects and Limitations | |
| 42 | − 5.2 Testing the Adapter | |
| 43 | − 5.2.1 Diagnostic Self-Test | |
| 44 | − 5.2.2 Diagnostic Network Test | |
| 45 | − 5.3 Using the Adapter's LEDs | |
| 46 | − 5.4 Resolving I/O Conflicts | |
| 47 | − | |
| 48 | −6.0 TECHNICAL SUPPORT | |
| 49 | − 6.1 Contacting Cirrus Logic's Technical Support | |
| 50 | − 6.2 Information Required Before Contacting Technical Support | |
| 51 | − 6.3 Obtaining the Latest Driver Version | |
| 52 | − 6.4 Current maintainer | |
| 53 | − 6.5 Kernel boot parameters | |
| 54 | − | |
| 55 | − | |
| 56 | −1.0 CIRRUS LOGIC LAN CS8900/CS8920 ETHERNET ADAPTERS | |
| 57 | −=============================================================================== | |
| 58 | − | |
| 59 | − | |
| 60 | −1.1 PRODUCT OVERVIEW | |
| 61 | − | |
| 62 | −The CS8900-based ISA Ethernet Adapters from Cirrus Logic follow | |
| 63 | −IEEE 802.3 standards and support half or full-duplex operation in ISA bus | |
| 64 | −computers on 10 Mbps Ethernet networks. The adapters are designed for operation | |
| 65 | −in 16-bit ISA or EISA bus expansion slots and are available in | |
| 66 | −10BaseT-only or 3-media configurations (10BaseT, 10Base2, and AUI for 10Base-5 | |
| 67 | −or fiber networks). | |
| 68 | − | |
| 69 | −CS8920-based adapters are similar to the CS8900-based adapter with additional | |
| 70 | −features for Plug and Play (PnP) support and Wakeup Frame recognition. As | |
| 71 | −such, the configuration procedures differ somewhat between the two types of | |
| 72 | −adapters. Refer to the "Adapter Configuration" section for details on | |
| 20 | + | |
| 21 | + | |
| 22 | +.. TABLE OF CONTENTS | |
| 23 | + | |
| 24 | + 1.0 CIRRUS LOGIC LAN CS8900/CS8920 ETHERNET ADAPTERS | |
| 25 | + 1.1 Product Overview | |
| 26 | + 1.2 Driver Description | |
| 27 | + 1.2.1 Driver Name | |
| 28 | + 1.2.2 File in the Driver Package | |
| 29 | + 1.3 System Requirements | |
| 30 | + 1.4 Licensing Information | |
| 31 | + | |
| 32 | + 2.0 ADAPTER INSTALLATION and CONFIGURATION | |
| 33 | + 2.1 CS8900-based Adapter Configuration | |
| 34 | + 2.2 CS8920-based Adapter Configuration | |
| 35 | + | |
| 36 | + 3.0 LOADING THE DRIVER AS A MODULE | |
| 37 | + | |
| 38 | + 4.0 COMPILING THE DRIVER | |
| 39 | + 4.1 Compiling the Driver as a Loadable Module | |
| 40 | + 4.2 Compiling the driver to support memory mode | |
| 41 | + 4.3 Compiling the driver to support Rx DMA | |
| 42 | + | |
| 43 | + 5.0 TESTING AND TROUBLESHOOTING | |
| 44 | + 5.1 Known Defects and Limitations | |
| 45 | + 5.2 Testing the Adapter | |
| 46 | + 5.2.1 Diagnostic Self-Test | |
| 47 | + 5.2.2 Diagnostic Network Test | |
| 48 | + 5.3 Using the Adapter's LEDs | |
| 49 | + 5.4 Resolving I/O Conflicts | |
| 50 | + | |
| 51 | + 6.0 TECHNICAL SUPPORT | |
| 52 | + 6.1 Contacting Cirrus Logic's Technical Support | |
| 53 | + 6.2 Information Required Before Contacting Technical Support | |
| 54 | + 6.3 Obtaining the Latest Driver Version | |
| 55 | + 6.4 Current maintainer | |
| 56 | + 6.5 Kernel boot parameters | |
| 57 | + | |
| 58 | + | |
| 59 | +1. Cirrus Logic LAN CS8900/CS8920 Ethernet Adapters | |
| 60 | +=================================================== | |
| 61 | + | |
| 62 | + | |
| 63 | +1.1. Product Overview | |
| 64 | +===================== | |
| 65 | + | |
| 66 | +The CS8900-based ISA Ethernet Adapters from Cirrus Logic follow | |
| 67 | +IEEE 802.3 standards and support half or full-duplex operation in ISA bus | |
| 68 | +computers on 10 Mbps Ethernet networks. The adapters are designed for operation | |
| 69 | +in 16-bit ISA or EISA bus expansion slots and are available in | |
| 70 | +10BaseT-only or 3-media configurations (10BaseT, 10Base2, and AUI for 10Base-5 | |
| 71 | +or fiber networks). | |
| 72 | + | |
| 73 | +CS8920-based adapters are similar to the CS8900-based adapter with additional | |
| 74 | +features for Plug and Play (PnP) support and Wakeup Frame recognition. As | |
| 75 | +such, the configuration procedures differ somewhat between the two types of | |
| 76 | +adapters. Refer to the "Adapter Configuration" section for details on | |
| 73 | 77 | configuring both types of adapters. |
| 74 | 78 | |
| 75 | 79 | |
| 76 | −1.2 DRIVER DESCRIPTION | |
| 80 | +1.2. Driver Description | |
| 81 | +======================= | |
| 77 | 82 | |
| 78 | 83 | The CS8900/CS8920 Ethernet Adapter driver for Linux supports the Linux |
| 79 | 84 | v2.3.48 or greater kernel. It can be compiled directly into the kernel |
| @@ -85,22 +90,25 @@ or loaded at run-time as a device driver module. · 5 unmodified lines | ||
| 85 | 90 | |
| 86 | 91 | The files in the driver at Cirrus' website include: |
| 87 | 92 | |
| 88 | − readme.txt - this file | |
| 89 | − build - batch file to compile cs89x0.c. | |
| 90 | − cs89x0.c - driver C code | |
| 91 | − cs89x0.h - driver header file | |
| 92 | − cs89x0.o - pre-compiled module (for v2.2.5 kernel) | |
| 93 | − config/Config.in - sample file to include cs89x0 driver in the kernel. | |
| 94 | − config/Makefile - sample file to include cs89x0 driver in the kernel. | |
| 95 | − config/Space.c - sample file to include cs89x0 driver in the kernel. | |
| 93 | + =================== ==================================================== | |
| 94 | + readme.txt this file | |
| 95 | + build batch file to compile cs89x0.c. | |
| 96 | + cs89x0.c driver C code | |
| 97 | + cs89x0.h driver header file | |
| 98 | + cs89x0.o pre-compiled module (for v2.2.5 kernel) | |
| 99 | + config/Config.in sample file to include cs89x0 driver in the kernel. | |
| 100 | + config/Makefile sample file to include cs89x0 driver in the kernel. | |
| 101 | + config/Space.c sample file to include cs89x0 driver in the kernel. | |
| 102 | + =================== ==================================================== | |
| 96 | 103 | |
| 97 | 104 | |
| 98 | 105 | |
| 99 | −1.3 SYSTEM REQUIREMENTS | |
| 106 | +1.3. System Requirements | |
| 107 | +------------------------ | |
| 100 | 108 | |
| 101 | 109 | The following hardware is required: |
| 102 | 110 | |
| 103 | − * Cirrus Logic LAN (CS8900/20-based) Ethernet ISA Adapter | |
| 111 | + * Cirrus Logic LAN (CS8900/20-based) Ethernet ISA Adapter | |
| 104 | 112 | |
| 105 | 113 | * IBM or IBM-compatible PC with: |
| 106 | 114 | * An 80386 or higher processor |
| @@ -118,20 +126,21 @@ The following software is required: · 11 unmodified lines | ||
| 118 | 126 | |
| 119 | 127 | * LINUX kernel sources for your kernel (if compiling into kernel) |
| 120 | 128 | |
| 121 | − * GNU Toolkit (gcc and make) v2.6 or above (if compiling into kernel | |
| 122 | − or a module) | |
| 129 | + * GNU Toolkit (gcc and make) v2.6 or above (if compiling into kernel | |
| 130 | + or a module) | |
| 123 | 131 | |
| 124 | 132 | |
| 125 | 133 | |
| 126 | −1.4 LICENSING INFORMATION | |
| 134 | +1.4. Licensing Information | |
| 135 | +-------------------------- | |
| 127 | 136 | |
| 128 | 137 | This program is free software; you can redistribute it and/or modify it under |
| 129 | 138 | the terms of the GNU General Public License as published by the Free Software |
| 130 | 139 | Foundation, version 1. |
| 131 | 140 | |
| 132 | 141 | This program is distributed in the hope that it will be useful, but WITHOUT |
| 133 | −ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 134 | −FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for | |
| 142 | +ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 143 | +FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for | |
| 135 | 144 | more details. |
| 136 | 145 | |
| 137 | 146 | For a full copy of the GNU General Public License, write to the Free Software |
| @@ -139,28 +148,29 @@ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. · 1 unmodified line | ||
| 139 | 148 | |
| 140 | 149 | |
| 141 | 150 | |
| 142 | −2.0 ADAPTER INSTALLATION and CONFIGURATION | |
| 143 | −=============================================================================== | |
| 151 | +2. Adapter Installation and Configuration | |
| 152 | +========================================= | |
| 144 | 153 | |
| 145 | −Both the CS8900 and CS8920-based adapters can be configured using parameters | |
| 146 | −stored in an on-board EEPROM. You must use the DOS-based CS8900/20 Setup | |
| 147 | −Utility if you want to change the adapter's configuration in EEPROM. | |
| 154 | +Both the CS8900 and CS8920-based adapters can be configured using parameters | |
| 155 | +stored in an on-board EEPROM. You must use the DOS-based CS8900/20 Setup | |
| 156 | +Utility if you want to change the adapter's configuration in EEPROM. | |
| 148 | 157 | |
| 149 | −When loading the driver as a module, you can specify many of the adapter's | |
| 150 | −configuration parameters on the command-line to override the EEPROM's settings | |
| 151 | −or for interface configuration when an EEPROM is not used. (CS8920-based | |
| 158 | +When loading the driver as a module, you can specify many of the adapter's | |
| 159 | +configuration parameters on the command-line to override the EEPROM's settings | |
| 160 | +or for interface configuration when an EEPROM is not used. (CS8920-based | |
| 152 | 161 | adapters must use an EEPROM.) See Section 3.0 LOADING THE DRIVER AS A MODULE. |
| 153 | 162 | |
| 154 | −Since the CS8900/20 Setup Utility is a DOS-based application, you must install | |
| 155 | −and configure the adapter in a DOS-based system using the CS8900/20 Setup | |
| 156 | −Utility before installation in the target LINUX system. (Not required if | |
| 163 | +Since the CS8900/20 Setup Utility is a DOS-based application, you must install | |
| 164 | +and configure the adapter in a DOS-based system using the CS8900/20 Setup | |
| 165 | +Utility before installation in the target LINUX system. (Not required if | |
| 157 | 166 | installing a CS8900-based adapter and the default configuration is acceptable.) |
| 158 | − | |
| 159 | 167 | |
| 160 | −2.1 CS8900-BASED ADAPTER CONFIGURATION | |
| 161 | 168 | |
| 162 | −CS8900-based adapters shipped from Cirrus Logic have been configured | |
| 163 | −with the following "default" settings: | |
| 169 | +2.1. CS8900-based Adapter Configuration | |
| 170 | +--------------------------------------- | |
| 171 | + | |
| 172 | +CS8900-based adapters shipped from Cirrus Logic have been configured | |
| 173 | +with the following "default" settings:: | |
| 164 | 174 | |
| 165 | 175 | Operation Mode: Memory Mode |
| 166 | 176 | IRQ: 10 |
| @@ -169,15 +179,16 @@ with the following "default" settings: · 2 unmodified lines | ||
| 169 | 179 | Optimization: DOS Client |
| 170 | 180 | Transmission Mode: Half-duplex |
| 171 | 181 | BootProm: None |
| 172 | − Media Type: Autodetect (3-media cards) or | |
| 173 | − 10BASE-T (10BASE-T only adapter) | |
| 182 | + Media Type: Autodetect (3-media cards) or | |
| 183 | + 10BASE-T (10BASE-T only adapter) | |
| 174 | 184 | |
| 175 | −You should only change the default configuration settings if conflicts with | |
| 176 | −another adapter exists. To change the adapter's configuration, run the | |
| 177 | −CS8900/20 Setup Utility. | |
| 185 | +You should only change the default configuration settings if conflicts with | |
| 186 | +another adapter exists. To change the adapter's configuration, run the | |
| 187 | +CS8900/20 Setup Utility. | |
| 178 | 188 | |
| 179 | 189 | |
| 180 | −2.2 CS8920-BASED ADAPTER CONFIGURATION | |
| 190 | +2.2. CS8920-based Adapter Configuration | |
| 191 | +--------------------------------------- | |
| 181 | 192 | |
| 182 | 193 | CS8920-based adapters are shipped from Cirrus Logic configured as Plug |
| 183 | 194 | and Play (PnP) enabled. However, since the cs89x0 driver does NOT |
| @@ -185,82 +196,83 @@ support PnP, you must install the CS8920 adapter in a DOS-based PC and · 1 unmodified line | ||
| 185 | 196 | run the CS8900/20 Setup Utility to disable PnP and configure the |
| 186 | 197 | adapter before installation in the target Linux system. Failure to do |
| 187 | 198 | this will leave the adapter inactive and the driver will be unable to |
| 188 | −communicate with the adapter. | |
| 199 | +communicate with the adapter. | |
| 189 | 200 | |
| 201 | +:: | |
| 190 | 202 | |
| 191 | − **************************************************************** | |
| 192 | − * CS8920-BASED ADAPTERS: * | |
| 193 | − * * | |
| 194 | − * CS8920-BASED ADAPTERS ARE PLUG and PLAY ENABLED BY DEFAULT. * | |
| 195 | − * THE CS89X0 DRIVER DOES NOT SUPPORT PnP. THEREFORE, YOU MUST * | |
| 196 | − * RUN THE CS8900/20 SETUP UTILITY TO DISABLE PnP SUPPORT AND * | |
| 197 | − * TO ACTIVATE THE ADAPTER. * | |
| 198 | − **************************************************************** | |
| 203 | + **************************************************************** | |
| 204 | + * CS8920-BASED ADAPTERS: * | |
| 205 | + * * | |
| 206 | + * CS8920-BASED ADAPTERS ARE PLUG and PLAY ENABLED BY DEFAULT. * | |
| 207 | + * THE CS89X0 DRIVER DOES NOT SUPPORT PnP. THEREFORE, YOU MUST * | |
| 208 | + * RUN THE CS8900/20 SETUP UTILITY TO DISABLE PnP SUPPORT AND * | |
| 209 | + * TO ACTIVATE THE ADAPTER. * | |
| 210 | + **************************************************************** | |
| 199 | 211 | |
| 200 | 212 | |
| 201 | 213 | |
| 202 | 214 | |
| 203 | −3.0 LOADING THE DRIVER AS A MODULE | |
| 204 | −=============================================================================== | |
| 215 | +3. Loading the Driver as a Module | |
| 216 | +================================= | |
| 205 | 217 | |
| 206 | 218 | If the driver is compiled as a loadable module, you can load the driver module |
| 207 | −with the 'modprobe' command. Many of the adapter's configuration parameters can | |
| 208 | −be specified as command-line arguments to the load command. This facility | |
| 209 | −provides a means to override the EEPROM's settings or for interface | |
| 219 | +with the 'modprobe' command. Many of the adapter's configuration parameters can | |
| 220 | +be specified as command-line arguments to the load command. This facility | |
| 221 | +provides a means to override the EEPROM's settings or for interface | |
| 210 | 222 | configuration when an EEPROM is not used. |
| 211 | 223 | |
| 212 | −Example: | |
| 224 | +Example:: | |
| 213 | 225 | |
| 214 | 226 | insmod cs89x0.o io=0x200 irq=0xA media=aui |
| 215 | 227 | |
| 216 | 228 | This example loads the module and configures the adapter to use an IO port base |
| 217 | 229 | address of 200h, interrupt 10, and use the AUI media connection. The following |
| 218 | −configuration options are available on the command line: | |
| 219 | − | |
| 220 | −* io=### - specify IO address (200h-360h) | |
| 221 | −* irq=## - specify interrupt level | |
| 222 | −* use_dma=1 - Enable DMA | |
| 223 | −* dma=# - specify dma channel (Driver is compiled to support | |
| 224 | − Rx DMA only) | |
| 225 | −* dmasize=# (16 or 64) - DMA size 16K or 64K. Default value is set to 16. | |
| 226 | −* media=rj45 - specify media type | |
| 230 | +configuration options are available on the command line:: | |
| 231 | + | |
| 232 | + io=### - specify IO address (200h-360h) | |
| 233 | + irq=## - specify interrupt level | |
| 234 | + use_dma=1 - Enable DMA | |
| 235 | + dma=# - specify dma channel (Driver is compiled to support | |
| 236 | + Rx DMA only) | |
| 237 | + dmasize=# (16 or 64) - DMA size 16K or 64K. Default value is set to 16. | |
| 238 | + media=rj45 - specify media type | |
| 227 | 239 | or media=bnc |
| 228 | 240 | or media=aui |
| 229 | 241 | or media=auto |
| 230 | −* duplex=full - specify forced half/full/autonegotiate duplex | |
| 242 | + duplex=full - specify forced half/full/autonegotiate duplex | |
| 231 | 243 | or duplex=half |
| 232 | 244 | or duplex=auto |
| 233 | −* debug=# - debug level (only available if the driver was compiled | |
| 234 | − for debugging) | |
| 245 | + debug=# - debug level (only available if the driver was compiled | |
| 246 | + for debugging) | |
| 235 | 247 | |
| 236 | −NOTES: | |
| 248 | +**Notes:** | |
| 237 | 249 | |
| 238 | 250 | a) If an EEPROM is present, any specified command-line parameter |
| 239 | 251 | will override the corresponding configuration value stored in |
| 240 | 252 | EEPROM. |
| 241 | 253 | |
| 242 | −b) The "io" parameter must be specified on the command-line. | |
| 254 | +b) The "io" parameter must be specified on the command-line. | |
| 243 | 255 | |
| 244 | 256 | c) The driver's hardware probe routine is designed to avoid |
| 245 | 257 | writing to I/O space until it knows that there is a cs89x0 |
| 246 | 258 | card at the written addresses. This could cause problems |
| 247 | 259 | with device probing. To avoid this behaviour, add one |
| 248 | − to the `io=' module parameter. This doesn't actually change | |
| 260 | + to the ``io=`` module parameter. This doesn't actually change | |
| 249 | 261 | the I/O address, but it is a flag to tell the driver |
| 250 | 262 | to partially initialise the hardware before trying to |
| 251 | 263 | identify the card. This could be dangerous if you are |
| 252 | 264 | not sure that there is a cs89x0 card at the provided address. |
| 253 | 265 | |
| 254 | 266 | For example, to scan for an adapter located at IO base 0x300, |
| 255 | − specify an IO address of 0x301. | |
| 267 | + specify an IO address of 0x301. | |
| 256 | 268 | |
| 257 | 269 | d) The "duplex=auto" parameter is only supported for the CS8920. |
| 258 | 270 | |
| 259 | 271 | e) The minimum command-line configuration required if an EEPROM is |
| 260 | 272 | not present is: |
| 261 | 273 | |
| 262 | − io | |
| 263 | − irq | |
| 274 | + io | |
| 275 | + irq | |
| 264 | 276 | media type (no autodetect) |
| 265 | 277 | |
| 266 | 278 | f) The following additional parameters are CS89XX defaults (values |
| @@ -282,13 +294,13 @@ h) Many Linux distributions use the 'modprobe' command to load · 15 unmodified lines | ||
| 282 | 294 | module when it is loaded. All the configuration options which are |
| 283 | 295 | described above may be placed within /etc/conf.modules. |
| 284 | 296 | |
| 285 | − For example: | |
| 297 | + For example:: | |
| 286 | 298 | |
| 287 | − > cat /etc/conf.modules | |
| 288 | − ... | |
| 289 | − alias eth0 cs89x0 | |
| 290 | − options cs89x0 io=0x0200 dma=5 use_dma=1 | |
| 291 | − ... | |
| 299 | + > cat /etc/conf.modules | |
| 300 | + ... | |
| 301 | + alias eth0 cs89x0 | |
| 302 | + options cs89x0 io=0x0200 dma=5 use_dma=1 | |
| 303 | + ... | |
| 292 | 304 | |
| 293 | 305 | In this example we are telling the module system that the |
| 294 | 306 | ethernet driver for this machine should use the cs89x0 driver. We |
| @@ -305,9 +317,9 @@ j) The cs89x0 supports DMA for receiving only. DMA mode is · 10 unmodified lines | ||
| 305 | 317 | |
| 306 | 318 | k) If your Linux kernel was compiled with inbuilt plug-and-play |
| 307 | 319 | support you will be able to find information about the cs89x0 card |
| 308 | − with the command | |
| 320 | + with the command:: | |
| 309 | 321 | |
| 310 | − cat /proc/isapnp | |
| 322 | + cat /proc/isapnp | |
| 311 | 323 | |
| 312 | 324 | l) If during DMA operation you find erratic behavior or network data |
| 313 | 325 | corruption you should use your PC's BIOS to slow the EISA bus clock. |
| @@ -321,11 +333,11 @@ n) If the cs89x0 driver is compiled directly into the kernel, DMA · 7 unmodified lines | ||
| 321 | 333 | mode may be selected by providing the kernel with a boot option |
| 322 | 334 | 'cs89x0_dma=N' where 'N' is the desired DMA channel number (5, 6 or 7). |
| 323 | 335 | |
| 324 | − Kernel boot options may be provided on the LILO command line: | |
| 336 | + Kernel boot options may be provided on the LILO command line:: | |
| 325 | 337 | |
| 326 | 338 | LILO boot: linux cs89x0_dma=5 |
| 327 | 339 | |
| 328 | − or they may be placed in /etc/lilo.conf: | |
| 340 | + or they may be placed in /etc/lilo.conf:: | |
| 329 | 341 | |
| 330 | 342 | image=/boot/bzImage-2.3.48 |
| 331 | 343 | append="cs89x0_dma=5" |
| @@ -337,237 +349,246 @@ n) If the cs89x0 driver is compiled directly into the kernel, DMA · 5 unmodified lines | ||
| 337 | 349 | (64k mode is not available). |
| 338 | 350 | |
| 339 | 351 | |
| 340 | −4.0 COMPILING THE DRIVER | |
| 341 | −=============================================================================== | |
| 352 | +4. Compiling the Driver | |
| 353 | +======================= | |
| 342 | 354 | |
| 343 | 355 | The cs89x0 driver can be compiled directly into the kernel or compiled into |
| 344 | 356 | a loadable device driver module. |
| 345 | 357 | |
| 358 | +Just use the standard way to configure the driver and compile the Kernel. | |
| 346 | 359 | |
| 347 | −4.1 COMPILING THE DRIVER AS A LOADABLE MODULE | |
| 348 | − | |
| 349 | −To compile the driver into a loadable module, use the following command | |
| 350 | −(single command line, without quotes): | |
| 351 | − | |
| 352 | −"gcc -D__KERNEL__ -I/usr/src/linux/include -I/usr/src/linux/net/inet -Wall | |
| 353 | −-Wstrict-prototypes -O2 -fomit-frame-pointer -DMODULE -DCONFIG_MODVERSIONS | |
| 354 | −-c cs89x0.c" | |
| 355 | − | |
| 356 | −4.2 COMPILING THE DRIVER TO SUPPORT MEMORY MODE | |
| 357 | − | |
| 358 | −Support for memory mode was not carried over into the 2.3 series kernels. | |
| 359 | 360 | |
| 360 | −4.3 COMPILING THE DRIVER TO SUPPORT Rx DMA | |
| 361 | +4.1. Compiling the Driver to Support Rx DMA | |
| 362 | +------------------------------------------- | |
| 361 | 363 | |
| 362 | 364 | The compile-time optionality for DMA was removed in the 2.3 kernel |
| 363 | 365 | series. DMA support is now unconditionally part of the driver. It is |
| 364 | 366 | enabled by the 'use_dma=1' module option. |
| 365 | 367 | |
| 366 | 368 | |
| 367 | −5.0 TESTING AND TROUBLESHOOTING | |
| 368 | −=============================================================================== | |
| 369 | +5. Testing and Troubleshooting | |
| 370 | +============================== | |
| 369 | 371 | |
| 370 | −5.1 KNOWN DEFECTS and LIMITATIONS | |
| 372 | +5.1. Known Defects and Limitations | |
| 373 | +---------------------------------- | |
| 371 | 374 | |
| 372 | −Refer to the RELEASE.TXT file distributed as part of this archive for a list of | |
| 375 | +Refer to the RELEASE.TXT file distributed as part of this archive for a list of | |
| 373 | 376 | known defects, driver limitations, and work arounds. |
| 374 | 377 | |
| 375 | 378 | |
| 376 | −5.2 TESTING THE ADAPTER | |
| 379 | +5.2. Testing the Adapter | |
| 380 | +------------------------ | |
| 377 | 381 | |
| 378 | −Once the adapter has been installed and configured, the diagnostic option of | |
| 379 | −the CS8900/20 Setup Utility can be used to test the functionality of the | |
| 382 | +Once the adapter has been installed and configured, the diagnostic option of | |
| 383 | +the CS8900/20 Setup Utility can be used to test the functionality of the | |
| 380 | 384 | adapter and its network connection. Use the diagnostics 'Self Test' option to |
| 381 | 385 | test the functionality of the adapter with the hardware configuration you have |
| 382 | 386 | assigned. You can use the diagnostics 'Network Test' to test the ability of the |
| 383 | −adapter to communicate across the Ethernet with another PC equipped with a | |
| 384 | −CS8900/20-based adapter card (it must also be running the CS8900/20 Setup | |
| 387 | +adapter to communicate across the Ethernet with another PC equipped with a | |
| 388 | +CS8900/20-based adapter card (it must also be running the CS8900/20 Setup | |
| 385 | 389 | Utility). |
| 386 | 390 | |
| 387 | − NOTE: The Setup Utility's diagnostics are designed to run in a | |
| 388 | − DOS-only operating system environment. DO NOT run the diagnostics | |
| 389 | − from a DOS or command prompt session under Windows 95, Windows NT, | |
| 390 | − OS/2, or other operating system. | |
| 391 | +.. note:: | |
| 392 | + | |
| 393 | + The Setup Utility's diagnostics are designed to run in a | |
| 394 | + DOS-only operating system environment. DO NOT run the diagnostics | |
| 395 | + from a DOS or command prompt session under Windows 95, Windows NT, | |
| 396 | + OS/2, or other operating system. | |
| 391 | 397 | |
| 392 | 398 | To run the diagnostics tests on the CS8900/20 adapter: |
| 393 | 399 | |
| 394 | − 1.) Boot DOS on the PC and start the CS8900/20 Setup Utility. | |
| 400 | + 1. Boot DOS on the PC and start the CS8900/20 Setup Utility. | |
| 395 | 401 | |
| 396 | − 2.) The adapter's current configuration is displayed. Hit the ENTER key to | |
| 402 | + 2. The adapter's current configuration is displayed. Hit the ENTER key to | |
| 397 | 403 | get to the main menu. |
| 398 | 404 | |
| 399 | − 4.) Select 'Diagnostics' (ALT-G) from the main menu. | |
| 405 | + 4. Select 'Diagnostics' (ALT-G) from the main menu. | |
| 400 | 406 | * Select 'Self-Test' to test the adapter's basic functionality. |
| 401 | 407 | * Select 'Network Test' to test the network connection and cabling. |
| 402 | 408 | |
| 403 | 409 | |
| 404 | −5.2.1 DIAGNOSTIC SELF-TEST | |
| 410 | +5.2.1. Diagnostic Self-test | |
| 411 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 405 | 412 | |
| 406 | −The diagnostic self-test checks the adapter's basic functionality as well as | |
| 407 | −its ability to communicate across the ISA bus based on the system resources | |
| 413 | +The diagnostic self-test checks the adapter's basic functionality as well as | |
| 414 | +its ability to communicate across the ISA bus based on the system resources | |
| 408 | 415 | assigned during hardware configuration. The following tests are performed: |
| 409 | 416 | |
| 410 | 417 | * IO Register Read/Write Test |
| 411 | − The IO Register Read/Write test insures that the CS8900/20 can be | |
| 418 | + | |
| 419 | + The IO Register Read/Write test insures that the CS8900/20 can be | |
| 412 | 420 | accessed in IO mode, and that the IO base address is correct. |
| 413 | 421 | |
| 414 | 422 | * Shared Memory Test |
| 415 | − The Shared Memory test insures the CS8900/20 can be accessed in memory | |
| 416 | − mode and that the range of memory addresses assigned does not conflict | |
| 423 | + | |
| 424 | + The Shared Memory test insures the CS8900/20 can be accessed in memory | |
| 425 | + mode and that the range of memory addresses assigned does not conflict | |
| 417 | 426 | with other devices in the system. |
| 418 | 427 | |
| 419 | 428 | * Interrupt Test |
| 429 | + | |
| 420 | 430 | The Interrupt test insures there are no conflicts with the assigned IRQ |
| 421 | 431 | signal. |
| 422 | 432 | |
| 423 | 433 | * EEPROM Test |
| 434 | + | |
| 424 | 435 | The EEPROM test insures the EEPROM can be read. |
| 425 | 436 | |
| 426 | 437 | * Chip RAM Test |
| 438 | + | |
| 427 | 439 | The Chip RAM test insures the 4K of memory internal to the CS8900/20 is |
| 428 | 440 | working properly. |
| 429 | 441 | |
| 430 | 442 | * Internal Loop-back Test |
| 431 | − The Internal Loop Back test insures the adapter's transmitter and | |
| 432 | − receiver are operating properly. If this test fails, make sure the | |
| 433 | − adapter's cable is connected to the network (check for LED activity for | |
| 443 | + | |
| 444 | + The Internal Loop Back test insures the adapter's transmitter and | |
| 445 | + receiver are operating properly. If this test fails, make sure the | |
| 446 | + adapter's cable is connected to the network (check for LED activity for | |
| 434 | 447 | example). |
| 435 | 448 | |
| 436 | 449 | * Boot PROM Test |
| 450 | + | |
| 437 | 451 | The Boot PROM test insures the Boot PROM is present, and can be read. |
| 438 | 452 | Failure indicates the Boot PROM was not successfully read due to a |
| 439 | 453 | hardware problem or due to a conflicts on the Boot PROM address |
| 440 | 454 | assignment. (Test only applies if the adapter is configured to use the |
| 441 | 455 | Boot PROM option.) |
| 442 | 456 | |
| 443 | −Failure of a test item indicates a possible system resource conflict with | |
| 444 | −another device on the ISA bus. In this case, you should use the Manual Setup | |
| 457 | +Failure of a test item indicates a possible system resource conflict with | |
| 458 | +another device on the ISA bus. In this case, you should use the Manual Setup | |
| 445 | 459 | option to reconfigure the adapter by selecting a different value for the system |
| 446 | 460 | resource that failed. |
| 447 | 461 | |
| 448 | 462 | |
| 449 | −5.2.2 DIAGNOSTIC NETWORK TEST | |
| 463 | +5.2.2. Diagnostic Network Test | |
| 464 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 450 | 465 | |
| 451 | −The Diagnostic Network Test verifies a working network connection by | |
| 452 | −transferring data between two CS8900/20 adapters installed in different PCs | |
| 453 | −on the same network. (Note: the diagnostic network test should not be run | |
| 454 | −between two nodes across a router.) | |
| 466 | +The Diagnostic Network Test verifies a working network connection by | |
| 467 | +transferring data between two CS8900/20 adapters installed in different PCs | |
| 468 | +on the same network. (Note: the diagnostic network test should not be run | |
| 469 | +between two nodes across a router.) | |
| 455 | 470 | |
| 456 | 471 | This test requires that each of the two PCs have a CS8900/20-based adapter |
| 457 | −installed and have the CS8900/20 Setup Utility running. The first PC is | |
| 458 | −configured as a Responder and the other PC is configured as an Initiator. | |
| 459 | −Once the Initiator is started, it sends data frames to the Responder which | |
| 472 | +installed and have the CS8900/20 Setup Utility running. The first PC is | |
| 473 | +configured as a Responder and the other PC is configured as an Initiator. | |
| 474 | +Once the Initiator is started, it sends data frames to the Responder which | |
| 460 | 475 | returns the frames to the Initiator. |
| 461 | 476 | |
| 462 | −The total number of frames received and transmitted are displayed on the | |
| 463 | −Initiator's display, along with a count of the number of frames received and | |
| 464 | −transmitted OK or in error. The test can be terminated anytime by the user at | |
| 477 | +The total number of frames received and transmitted are displayed on the | |
| 478 | +Initiator's display, along with a count of the number of frames received and | |
| 479 | +transmitted OK or in error. The test can be terminated anytime by the user at | |
| 465 | 480 | either PC. |
| 466 | 481 | |
| 467 | 482 | To setup the Diagnostic Network Test: |
| 468 | 483 | |
| 469 | − 1.) Select a PC with a CS8900/20-based adapter and a known working network | |
| 470 | − connection to act as the Responder. Run the CS8900/20 Setup Utility | |
| 471 | − and select 'Diagnostics -> Network Test -> Responder' from the main | |
| 472 | − menu. Hit ENTER to start the Responder. | |
| 484 | + 1. Select a PC with a CS8900/20-based adapter and a known working network | |
| 485 | + connection to act as the Responder. Run the CS8900/20 Setup Utility | |
| 486 | + and select 'Diagnostics -> Network Test -> Responder' from the main | |
| 487 | + menu. Hit ENTER to start the Responder. | |
| 473 | 488 | |
| 474 | − 2.) Return to the PC with the CS8900/20-based adapter you want to test and | |
| 475 | − start the CS8900/20 Setup Utility. | |
| 489 | + 2. Return to the PC with the CS8900/20-based adapter you want to test and | |
| 490 | + start the CS8900/20 Setup Utility. | |
| 491 | + | |
| 492 | + 3. From the main menu, Select 'Diagnostic -> Network Test -> Initiator'. | |
| 493 | + Hit ENTER to start the test. | |
| 476 | 494 | |
| 477 | − 3.) From the main menu, Select 'Diagnostic -> Network Test -> Initiator'. | |
| 478 | − Hit ENTER to start the test. | |
| 479 | − | |
| 480 | 495 | You may stop the test on the Initiator at any time while allowing the Responder |
| 481 | −to continue running. In this manner, you can move to additional PCs and test | |
| 482 | −them by starting the Initiator on another PC without having to stop/start the | |
| 496 | +to continue running. In this manner, you can move to additional PCs and test | |
| 497 | +them by starting the Initiator on another PC without having to stop/start the | |
| 483 | 498 | Responder. |
| 484 | − | |
| 485 | 499 | |
| 486 | 500 | |
| 487 | −5.3 USING THE ADAPTER'S LEDs | |
| 488 | 501 | |
| 489 | −The 2 and 3-media adapters have two LEDs visible on the back end of the board | |
| 490 | −located near the 10Base-T connector. | |
| 502 | +5.3. Using the Adapter's LEDs | |
| 503 | +----------------------------- | |
| 504 | + | |
| 505 | +The 2 and 3-media adapters have two LEDs visible on the back end of the board | |
| 506 | +located near the 10Base-T connector. | |
| 491 | 507 | |
| 492 | −Link Integrity LED: A "steady" ON of the green LED indicates a valid 10Base-T | |
| 508 | +Link Integrity LED: A "steady" ON of the green LED indicates a valid 10Base-T | |
| 493 | 509 | connection. (Only applies to 10Base-T. The green LED has no significance for |
| 494 | 510 | a 10Base-2 or AUI connection.) |
| 495 | 511 | |
| 496 | −TX/RX LED: The yellow LED lights briefly each time the adapter transmits or | |
| 512 | +TX/RX LED: The yellow LED lights briefly each time the adapter transmits or | |
| 497 | 513 | receives data. (The yellow LED will appear to "flicker" on a typical network.) |
| 498 | 514 | |
| 499 | 515 | |
| 500 | −5.4 RESOLVING I/O CONFLICTS | |
| 516 | +5.4. Resolving I/O Conflicts | |
| 517 | +---------------------------- | |
| 501 | 518 | |
| 502 | −An IO conflict occurs when two or more adapter use the same ISA resource (IO | |
| 503 | −address, memory address or IRQ). You can usually detect an IO conflict in one | |
| 519 | +An IO conflict occurs when two or more adapter use the same ISA resource (IO | |
| 520 | +address, memory address or IRQ). You can usually detect an IO conflict in one | |
| 504 | 521 | of four ways after installing and or configuring the CS8900/20-based adapter: |
| 505 | 522 | |
| 506 | − 1.) The system does not boot properly (or at all). | |
| 523 | + 1. The system does not boot properly (or at all). | |
| 507 | 524 | |
| 508 | − 2.) The driver cannot communicate with the adapter, reporting an "Adapter | |
| 509 | − not found" error message. | |
| 525 | + 2. The driver cannot communicate with the adapter, reporting an "Adapter | |
| 526 | + not found" error message. | |
| 510 | 527 | |
| 511 | − 3.) You cannot connect to the network or the driver will not load. | |
| 528 | + 3. You cannot connect to the network or the driver will not load. | |
| 512 | 529 | |
| 513 | − 4.) If you have configured the adapter to run in memory mode but the driver | |
| 514 | − reports it is using IO mode when loading, this is an indication of a | |
| 515 | − memory address conflict. | |
| 530 | + 4. If you have configured the adapter to run in memory mode but the driver | |
| 531 | + reports it is using IO mode when loading, this is an indication of a | |
| 532 | + memory address conflict. | |
| 516 | 533 | |
| 517 | −If an IO conflict occurs, run the CS8900/20 Setup Utility and perform a | |
| 518 | −diagnostic self-test. Normally, the ISA resource in conflict will fail the | |
| 519 | −self-test. If so, reconfigure the adapter selecting another choice for the | |
| 520 | −resource in conflict. Run the diagnostics again to check for further IO | |
| 534 | +If an IO conflict occurs, run the CS8900/20 Setup Utility and perform a | |
| 535 | +diagnostic self-test. Normally, the ISA resource in conflict will fail the | |
| 536 | +self-test. If so, reconfigure the adapter selecting another choice for the | |
| 537 | +resource in conflict. Run the diagnostics again to check for further IO | |
| 521 | 538 | conflicts. |
| 522 | 539 | |
| 523 | 540 | In some cases, such as when the PC will not boot, it may be necessary to remove |
| 524 | −the adapter and reconfigure it by installing it in another PC to run the | |
| 525 | −CS8900/20 Setup Utility. Once reinstalled in the target system, run the | |
| 526 | −diagnostics self-test to ensure the new configuration is free of conflicts | |
| 541 | +the adapter and reconfigure it by installing it in another PC to run the | |
| 542 | +CS8900/20 Setup Utility. Once reinstalled in the target system, run the | |
| 543 | +diagnostics self-test to ensure the new configuration is free of conflicts | |
| 527 | 544 | before loading the driver again. |
| 528 | 545 | |
| 529 | −When manually configuring the adapter, keep in mind the typical ISA system | |
| 546 | +When manually configuring the adapter, keep in mind the typical ISA system | |
| 530 | 547 | resource usage as indicated in the tables below. |
| 531 | 548 | |
| 532 | −I/O Address Device IRQ Device | |
| 533 | −----------- -------- --- -------- | |
| 534 | − 200-20F Game I/O adapter 3 COM2, Bus Mouse | |
| 535 | − 230-23F Bus Mouse 4 COM1 | |
| 536 | − 270-27F LPT3: third parallel port 5 LPT2 | |
| 537 | − 2F0-2FF COM2: second serial port 6 Floppy Disk controller | |
| 538 | − 320-32F Fixed disk controller 7 LPT1 | |
| 539 | − 8 Real-time Clock | |
| 540 | − 9 EGA/VGA display adapter | |
| 541 | − 12 Mouse (PS/2) | |
| 542 | −Memory Address Device 13 Math Coprocessor | |
| 543 | −-------------- --------------------- 14 Hard Disk controller | |
| 544 | −A000-BFFF EGA Graphics Adapter | |
| 545 | −A000-C7FF VGA Graphics Adapter | |
| 546 | −B000-BFFF Mono Graphics Adapter | |
| 547 | −B800-BFFF Color Graphics Adapter | |
| 548 | −E000-FFFF AT BIOS | |
| 549 | +:: | |
| 549 | 550 | |
| 551 | + I/O Address Device IRQ Device | |
| 552 | + ----------- -------- --- -------- | |
| 553 | + 200-20F Game I/O adapter 3 COM2, Bus Mouse | |
| 554 | + 230-23F Bus Mouse 4 COM1 | |
| 555 | + 270-27F LPT3: third parallel port 5 LPT2 | |
| 556 | + 2F0-2FF COM2: second serial port 6 Floppy Disk controller | |
| 557 | + 320-32F Fixed disk controller 7 LPT1 | |
| 558 | + 8 Real-time Clock | |
| 559 | + 9 EGA/VGA display adapter | |
| 560 | + 12 Mouse (PS/2) | |
| 561 | + Memory Address Device 13 Math Coprocessor | |
| 562 | + -------------- --------------------- 14 Hard Disk controller | |
| 563 | + A000-BFFF EGA Graphics Adapter | |
| 564 | + A000-C7FF VGA Graphics Adapter | |
| 565 | + B000-BFFF Mono Graphics Adapter | |
| 566 | + B800-BFFF Color Graphics Adapter | |
| 567 | + E000-FFFF AT BIOS | |
| 550 | 568 | |
| 551 | 569 | |
| 552 | 570 | |
| 553 | −6.0 TECHNICAL SUPPORT | |
| 554 | −=============================================================================== | |
| 555 | 571 | |
| 556 | −6.1 CONTACTING CIRRUS LOGIC'S TECHNICAL SUPPORT | |
| 572 | +6. Technical Support | |
| 573 | +==================== | |
| 557 | 574 | |
| 558 | −Cirrus Logic's CS89XX Technical Application Support can be reached at: | |
| 575 | +6.1. Contacting Cirrus Logic's Technical Support | |
| 576 | +------------------------------------------------ | |
| 559 | 577 | |
| 560 | −Telephone :(800) 888-5016 (from inside U.S. and Canada) | |
| 561 | − :(512) 442-7555 (from outside the U.S. and Canada) | |
| 562 | −Fax :(512) 912-3871 | |
| 563 | −Email :ethernet@crystal.cirrus.com | |
| 564 | −WWW :http://www.cirrus.com | |
| 578 | +Cirrus Logic's CS89XX Technical Application Support can be reached at:: | |
| 565 | 579 | |
| 580 | + Telephone :(800) 888-5016 (from inside U.S. and Canada) | |
| 581 | + :(512) 442-7555 (from outside the U.S. and Canada) | |
| 582 | + Fax :(512) 912-3871 | |
| 583 | + Email :ethernet@crystal.cirrus.com | |
| 584 | + WWW :http://www.cirrus.com | |
| 566 | 585 | |
| 567 | −6.2 INFORMATION REQUIRED BEFORE CONTACTING TECHNICAL SUPPORT | |
| 568 | 586 | |
| 569 | −Before contacting Cirrus Logic for technical support, be prepared to provide as | |
| 570 | −Much of the following information as possible. | |
| 587 | +6.2. Information Required before Contacting Technical Support | |
| 588 | +------------------------------------------------------------- | |
| 589 | + | |
| 590 | +Before contacting Cirrus Logic for technical support, be prepared to provide as | |
| 591 | +Much of the following information as possible. | |
| 571 | 592 | |
| 572 | 593 | 1.) Adapter type (CRD8900, CDB8900, CDB8920, etc.) |
| 573 | 594 | |
| @@ -575,7 +596,7 @@ Much of the following information as possible. · 1 unmodified line | ||
| 575 | 596 | |
| 576 | 597 | * IO Base, Memory Base, IO or memory mode enabled, IRQ, DMA channel |
| 577 | 598 | * Plug and Play enabled/disabled (CS8920-based adapters only) |
| 578 | − * Configured for media auto-detect or specific media type (which type). | |
| 599 | + * Configured for media auto-detect or specific media type (which type). | |
| 579 | 600 | |
| 580 | 601 | 3.) PC System's Configuration |
| 581 | 602 | |
| @@ -590,35 +611,37 @@ Much of the following information as possible. · 8 unmodified lines | ||
| 590 | 611 | |
| 591 | 612 | * CS89XX driver and version |
| 592 | 613 | * Your network operating system and version |
| 593 | − * Your system's OS version | |
| 614 | + * Your system's OS version | |
| 594 | 615 | * Version of all protocol support files |
| 595 | 616 | |
| 596 | 617 | 5.) Any Error Message displayed. |
| 597 | 618 | |
| 598 | 619 | |
| 599 | 620 | |
| 600 | −6.3 OBTAINING THE LATEST DRIVER VERSION | |
| 621 | +6.3 Obtaining the Latest Driver Version | |
| 622 | +--------------------------------------- | |
| 601 | 623 | |
| 602 | −You can obtain the latest CS89XX drivers and support software from Cirrus Logic's | |
| 624 | +You can obtain the latest CS89XX drivers and support software from Cirrus Logic's | |
| 603 | 625 | Web site. You can also contact Cirrus Logic's Technical Support (email: |
| 604 | −ethernet@crystal.cirrus.com) and request that you be registered for automatic | |
| 626 | +ethernet@crystal.cirrus.com) and request that you be registered for automatic | |
| 605 | 627 | software-update notification. |
| 606 | 628 | |
| 607 | 629 | Cirrus Logic maintains a web page at http://www.cirrus.com with the |
| 608 | 630 | latest drivers and technical publications. |
| 609 | 631 | |
| 610 | 632 | |
| 611 | −6.4 Current maintainer | |
| 633 | +6.4. Current maintainer | |
| 634 | +----------------------- | |
| 612 | 635 | |
| 613 | 636 | In February 2000 the maintenance of this driver was assumed by Andrew |
| 614 | 637 | Morton. |
| 615 | 638 | |
| 616 | 639 | 6.5 Kernel module parameters |
| 640 | +---------------------------- | |
| 617 | 641 | |
| 618 | 642 | For use in embedded environments with no cs89x0 EEPROM, the kernel boot |
| 619 | −parameter `cs89x0_media=' has been implemented. Usage is: | |
| 643 | +parameter ``cs89x0_media=`` has been implemented. Usage is:: | |
| 620 | 644 | |
| 621 | 645 | cs89x0_media=rj45 or |
| 622 | 646 | cs89x0_media=aui or |
| 623 | 647 | cs89x0_media=bnc |
| 624 | − | |
| @@ -1,7 +1,11 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +===================== | |
| 1 | 4 | DM9000 Network driver |
| 2 | 5 | ===================== |
| 3 | 6 | |
| 4 | 7 | Copyright 2008 Simtec Electronics, |
| 8 | + | |
| 5 | 9 | Ben Dooks <ben@simtec.co.uk> <ben-linux@fluff.org> |
| 6 | 10 | |
| 7 | 11 | |
| @@ -30,9 +34,9 @@ These resources should be specified in that order, as the ordering of the · 22 unmodified lines | ||
| 30 | 34 | two address regions is important (the driver expects these to be address |
| 31 | 35 | and then data). |
| 32 | 36 | |
| 33 | −An example from arch/arm/mach-s3c2410/mach-bast.c is: | |
| 37 | +An example from arch/arm/mach-s3c2410/mach-bast.c is:: | |
| 34 | 38 | |
| 35 | −static struct resource bast_dm9k_resource[] = { | |
| 39 | + static struct resource bast_dm9k_resource[] = { | |
| 36 | 40 | [0] = { |
| 37 | 41 | .start = S3C2410_CS5 + BAST_PA_DM9000, |
| 38 | 42 | .end = S3C2410_CS5 + BAST_PA_DM9000 + 3, |
| @@ -48,14 +52,14 @@ static struct resource bast_dm9k_resource[] = { · 9 unmodified lines | ||
| 48 | 52 | .end = IRQ_DM9000, |
| 49 | 53 | .flags = IORESOURCE_IRQ | IORESOURCE_IRQ_HIGHLEVEL, |
| 50 | 54 | } |
| 51 | −}; | |
| 55 | + }; | |
| 52 | 56 | |
| 53 | −static struct platform_device bast_device_dm9k = { | |
| 57 | + static struct platform_device bast_device_dm9k = { | |
| 54 | 58 | .name = "dm9000", |
| 55 | 59 | .id = 0, |
| 56 | 60 | .num_resources = ARRAY_SIZE(bast_dm9k_resource), |
| 57 | 61 | .resource = bast_dm9k_resource, |
| 58 | −}; | |
| 62 | + }; | |
| 59 | 63 | |
| 60 | 64 | Note the setting of the IRQ trigger flag in bast_dm9k_resource[2].flags, |
| 61 | 65 | as this will generate a warning if it is not present. The trigger from |
| @@ -64,13 +68,13 @@ handler to ensure that the IRQ is setup correctly. · 2 unmodified lines | ||
| 64 | 68 | |
| 65 | 69 | This shows a typical platform device, without the optional configuration |
| 66 | 70 | platform data supplied. The next example uses the same resources, but adds |
| 67 | −the optional platform data to pass extra configuration data: | |
| 71 | +the optional platform data to pass extra configuration data:: | |
| 68 | 72 | |
| 69 | −static struct dm9000_plat_data bast_dm9k_platdata = { | |
| 73 | + static struct dm9000_plat_data bast_dm9k_platdata = { | |
| 70 | 74 | .flags = DM9000_PLATF_16BITONLY, |
| 71 | −}; | |
| 75 | + }; | |
| 72 | 76 | |
| 73 | −static struct platform_device bast_device_dm9k = { | |
| 77 | + static struct platform_device bast_device_dm9k = { | |
| 74 | 78 | .name = "dm9000", |
| 75 | 79 | .id = 0, |
| 76 | 80 | .num_resources = ARRAY_SIZE(bast_dm9k_resource), |
| @@ -78,7 +82,7 @@ static struct platform_device bast_device_dm9k = { · 1 unmodified line | ||
| 78 | 82 | .dev = { |
| 79 | 83 | .platform_data = &bast_dm9k_platdata, |
| 80 | 84 | } |
| 81 | −}; | |
| 85 | + }; | |
| 82 | 86 | |
| 83 | 87 | The platform data is defined in include/linux/dm9000.h and described below. |
| 84 | 88 | |
| @@ -1,48 +1,54 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +=================================== | |
| 4 | +DEC EtherWORKS Ethernet De4x5 cards | |
| 5 | +=================================== | |
| 6 | + | |
| 1 | 7 | Originally, this driver was written for the Digital Equipment |
| 2 | 8 | Corporation series of EtherWORKS Ethernet cards: |
| 3 | 9 | |
| 4 | − DE425 TP/COAX EISA | |
| 5 | − DE434 TP PCI | |
| 6 | − DE435 TP/COAX/AUI PCI | |
| 7 | − DE450 TP/COAX/AUI PCI | |
| 8 | − DE500 10/100 PCI Fasternet | |
| 10 | + - DE425 TP/COAX EISA | |
| 11 | + - DE434 TP PCI | |
| 12 | + - DE435 TP/COAX/AUI PCI | |
| 13 | + - DE450 TP/COAX/AUI PCI | |
| 14 | + - DE500 10/100 PCI Fasternet | |
| 9 | 15 | |
| 10 | 16 | but it will now attempt to support all cards which conform to the |
| 11 | 17 | Digital Semiconductor SROM Specification. The driver currently |
| 12 | 18 | recognises the following chips: |
| 13 | 19 | |
| 14 | − DC21040 (no SROM) | |
| 15 | − DC21041[A] | |
| 16 | − DC21140[A] | |
| 17 | − DC21142 | |
| 18 | − DC21143 | |
| 20 | + - DC21040 (no SROM) | |
| 21 | + - DC21041[A] | |
| 22 | + - DC21140[A] | |
| 23 | + - DC21142 | |
| 24 | + - DC21143 | |
| 19 | 25 | |
| 20 | 26 | So far the driver is known to work with the following cards: |
| 21 | 27 | |
| 22 | − KINGSTON | |
| 23 | − Linksys | |
| 24 | − ZNYX342 | |
| 25 | − SMC8432 | |
| 26 | − SMC9332 (w/new SROM) | |
| 27 | − ZNYX31[45] | |
| 28 | − ZNYX346 10/100 4 port (can act as a 10/100 bridge!) | |
| 28 | + - KINGSTON | |
| 29 | + - Linksys | |
| 30 | + - ZNYX342 | |
| 31 | + - SMC8432 | |
| 32 | + - SMC9332 (w/new SROM) | |
| 33 | + - ZNYX31[45] | |
| 34 | + - ZNYX346 10/100 4 port (can act as a 10/100 bridge!) | |
| 29 | 35 | |
| 30 | 36 | The driver has been tested on a relatively busy network using the DE425, |
| 31 | 37 | DE434, DE435 and DE500 cards and benchmarked with 'ttcp': it transferred |
| 32 | − 16M of data to a DECstation 5000/200 as follows: | |
| 38 | + 16M of data to a DECstation 5000/200 as follows:: | |
| 33 | 39 | |
| 34 | − TCP UDP | |
| 35 | − TX RX TX RX | |
| 36 | − DE425 1030k 997k 1170k 1128k | |
| 37 | − DE434 1063k 995k 1170k 1125k | |
| 38 | − DE435 1063k 995k 1170k 1125k | |
| 39 | − DE500 1063k 998k 1170k 1125k in 10Mb/s mode | |
| 40 | + TCP UDP | |
| 41 | + TX RX TX RX | |
| 42 | + DE425 1030k 997k 1170k 1128k | |
| 43 | + DE434 1063k 995k 1170k 1125k | |
| 44 | + DE435 1063k 995k 1170k 1125k | |
| 45 | + DE500 1063k 998k 1170k 1125k in 10Mb/s mode | |
| 40 | 46 | |
| 41 | 47 | All values are typical (in kBytes/sec) from a sample of 4 for each |
| 42 | 48 | measurement. Their error is +/-20k on a quiet (private) network and also |
| 43 | 49 | depend on what load the CPU has. |
| 44 | 50 | |
| 45 | − ========================================================================= | |
| 51 | +---------------------------------------------------------------------------- | |
| 46 | 52 | |
| 47 | 53 | The ability to load this driver as a loadable module has been included |
| 48 | 54 | and used extensively during the driver development (to save those long |
| @@ -55,31 +61,33 @@ · 6 unmodified lines | ||
| 55 | 61 | |
| 56 | 62 | 0) have a copy of the loadable modules code installed on your system. |
| 57 | 63 | 1) copy de4x5.c from the /linux/drivers/net directory to your favourite |
| 58 | − temporary directory. | |
| 64 | + temporary directory. | |
| 59 | 65 | 2) for fixed autoprobes (not recommended), edit the source code near |
| 60 | − line 5594 to reflect the I/O address you're using, or assign these when | |
| 61 | − loading by: | |
| 66 | + line 5594 to reflect the I/O address you're using, or assign these when | |
| 67 | + loading by:: | |
| 62 | 68 | |
| 63 | − insmod de4x5 io=0xghh where g = bus number | |
| 64 | − hh = device number | |
| 69 | + insmod de4x5 io=0xghh where g = bus number | |
| 70 | + hh = device number | |
| 65 | 71 | |
| 66 | − NB: autoprobing for modules is now supported by default. You may just | |
| 67 | − use: | |
| 72 | + .. note:: | |
| 68 | 73 | |
| 69 | − insmod de4x5 | |
| 74 | + autoprobing for modules is now supported by default. You may just | |
| 75 | + use:: | |
| 70 | 76 | |
| 71 | − to load all available boards. For a specific board, still use | |
| 77 | + insmod de4x5 | |
| 78 | + | |
| 79 | + to load all available boards. For a specific board, still use | |
| 72 | 80 | the 'io=?' above. |
| 73 | 81 | 3) compile de4x5.c, but include -DMODULE in the command line to ensure |
| 74 | − that the correct bits are compiled (see end of source code). | |
| 82 | + that the correct bits are compiled (see end of source code). | |
| 75 | 83 | 4) if you are wanting to add a new card, goto 5. Otherwise, recompile a |
| 76 | − kernel with the de4x5 configuration turned off and reboot. | |
| 84 | + kernel with the de4x5 configuration turned off and reboot. | |
| 77 | 85 | 5) insmod de4x5 [io=0xghh] |
| 78 | − 6) run the net startup bits for your new eth?? interface(s) manually | |
| 79 | − (usually /etc/rc.inet[12] at boot time). | |
| 86 | + 6) run the net startup bits for your new eth?? interface(s) manually | |
| 87 | + (usually /etc/rc.inet[12] at boot time). | |
| 80 | 88 | 7) enjoy! |
| 81 | 89 | |
| 82 | − To unload a module, turn off the associated interface(s) | |
| 90 | + To unload a module, turn off the associated interface(s) | |
| 83 | 91 | 'ifconfig eth?? down' then 'rmmod de4x5'. |
| 84 | 92 | |
| 85 | 93 | Automedia detection is included so that in principle you can disconnect |
| @@ -90,7 +98,7 @@ · 4 unmodified lines | ||
| 90 | 98 | By default, the driver will now autodetect any DECchip based card. |
| 91 | 99 | Should you have a need to restrict the driver to DIGITAL only cards, you |
| 92 | 100 | can compile with a DEC_ONLY define, or if loading as a module, use the |
| 93 | − 'dec_only=1' parameter. | |
| 101 | + 'dec_only=1' parameter. | |
| 94 | 102 | |
| 95 | 103 | I've changed the timing routines to use the kernel timer and scheduling |
| 96 | 104 | functions so that the hangs and other assorted problems that occurred |
| @@ -158,18 +166,21 @@ · 61 unmodified lines | ||
| 158 | 166 | either at the end of the parameter list or with another board name. The |
| 159 | 167 | following parameters are allowed: |
| 160 | 168 | |
| 161 | − fdx for full duplex | |
| 162 | − autosense to set the media/speed; with the following | |
| 163 | − sub-parameters: | |
| 169 | + ========= =============================================== | |
| 170 | + fdx for full duplex | |
| 171 | + autosense to set the media/speed; with the following | |
| 172 | + sub-parameters: | |
| 164 | 173 | TP, TP_NW, BNC, AUI, BNC_AUI, 100Mb, 10Mb, AUTO |
| 174 | + ========= =============================================== | |
| 165 | 175 | |
| 166 | 176 | Case sensitivity is important for the sub-parameters. They *must* be |
| 167 | − upper case. Examples: | |
| 177 | + upper case. Examples:: | |
| 178 | + | |
| 179 | + insmod de4x5 args='eth1:fdx autosense=BNC eth0:autosense=100Mb'. | |
| 168 | 180 | |
| 169 | − insmod de4x5 args='eth1:fdx autosense=BNC eth0:autosense=100Mb'. | |
| 181 | + For a compiled in driver, in linux/drivers/net/CONFIG, place e.g.:: | |
| 170 | 182 | |
| 171 | − For a compiled in driver, in linux/drivers/net/CONFIG, place e.g. | |
| 172 | − DE4X5_OPTS = -DDE4X5_PARM='"eth0:fdx autosense=AUI eth2:autosense=TP"' | |
| 183 | + DE4X5_OPTS = -DDE4X5_PARM='"eth0:fdx autosense=AUI eth2:autosense=TP"' | |
| 173 | 184 | |
| 174 | 185 | Yes, I know full duplex isn't permissible on BNC or AUI; they're just |
| 175 | 186 | examples. By default, full duplex is turned off and AUTO is the default |
| @@ -1,6 +1,11 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +============================================================== | |
| 4 | +Davicom DM9102(A)/DM9132/DM9801 fast ethernet driver for Linux | |
| 5 | +============================================================== | |
| 6 | + | |
| 1 | 7 | Note: This driver doesn't have a maintainer. |
| 2 | 8 | |
| 3 | −Davicom DM9102(A)/DM9132/DM9801 fast ethernet driver for Linux. | |
| 4 | 9 | |
| 5 | 10 | This program is free software; you can redistribute it and/or |
| 6 | 11 | modify it under the terms of the GNU General Public License |
| @@ -16,29 +21,29 @@ GNU General Public License for more details. · 9 unmodified lines | ||
| 16 | 21 | This driver provides kernel support for Davicom DM9102(A)/DM9132/DM9801 ethernet cards ( CNET |
| 17 | 22 | 10/100 ethernet cards uses Davicom chipset too, so this driver supports CNET cards too ).If you |
| 18 | 23 | didn't compile this driver as a module, it will automatically load itself on boot and print a |
| 19 | −line similar to : | |
| 24 | +line similar to:: | |
| 20 | 25 | |
| 21 | 26 | dmfe: Davicom DM9xxx net driver, version 1.36.4 (2002-01-17) |
| 22 | 27 | |
| 23 | −If you compiled this driver as a module, you have to load it on boot.You can load it with command : | |
| 28 | +If you compiled this driver as a module, you have to load it on boot.You can load it with command:: | |
| 24 | 29 | |
| 25 | 30 | insmod dmfe |
| 26 | 31 | |
| 27 | 32 | This way it will autodetect the device mode.This is the suggested way to load the module.Or you can pass |
| 28 | −a mode= setting to module while loading, like : | |
| 33 | +a mode= setting to module while loading, like:: | |
| 29 | 34 | |
| 30 | 35 | insmod dmfe mode=0 # Force 10M Half Duplex |
| 31 | 36 | insmod dmfe mode=1 # Force 100M Half Duplex |
| 32 | 37 | insmod dmfe mode=4 # Force 10M Full Duplex |
| 33 | 38 | insmod dmfe mode=5 # Force 100M Full Duplex |
| 34 | 39 | |
| 35 | −Next you should configure your network interface with a command similar to : | |
| 40 | +Next you should configure your network interface with a command similar to:: | |
| 36 | 41 | |
| 37 | 42 | ifconfig eth0 172.22.3.18 |
| 38 | − ^^^^^^^^^^^ | |
| 43 | + ^^^^^^^^^^^ | |
| 39 | 44 | Your IP Address |
| 40 | 45 | |
| 41 | −Then you may have to modify the default routing table with command : | |
| 46 | +Then you may have to modify the default routing table with command:: | |
| 42 | 47 | |
| 43 | 48 | route add default eth0 |
| 44 | 49 | |
| @@ -48,10 +53,10 @@ Now your ethernet card should be up and running. · 3 unmodified lines | ||
| 48 | 53 | |
| 49 | 54 | TODO: |
| 50 | 55 | |
| 51 | −Implement pci_driver::suspend() and pci_driver::resume() power management methods. | |
| 52 | −Check on 64 bit boxes. | |
| 53 | −Check and fix on big endian boxes. | |
| 54 | −Test and make sure PCI latency is now correct for all cases. | |
| 56 | +- Implement pci_driver::suspend() and pci_driver::resume() power management methods. | |
| 57 | +- Check on 64 bit boxes. | |
| 58 | +- Check and fix on big endian boxes. | |
| 59 | +- Test and make sure PCI latency is now correct for all cases. | |
| 55 | 60 | |
| 56 | 61 | |
| 57 | 62 | Authors: |
| @@ -60,7 +65,7 @@ Sten Wang <sten_wang@davicom.com.tw > : Original Author · 2 unmodified lines | ||
| 60 | 65 | |
| 61 | 66 | Contributors: |
| 62 | 67 | |
| 63 | −Marcelo Tosatti <marcelo@conectiva.com.br> | |
| 64 | −Alan Cox <alan@lxorguk.ukuu.org.uk> | |
| 65 | −Jeff Garzik <jgarzik@pobox.com> | |
| 66 | −Vojtech Pavlik <vojtech@suse.cz> | |
| 68 | +- Marcelo Tosatti <marcelo@conectiva.com.br> | |
| 69 | +- Alan Cox <alan@lxorguk.ukuu.org.uk> | |
| 70 | +- Jeff Garzik <jgarzik@pobox.com> | |
| 71 | +- Vojtech Pavlik <vojtech@suse.cz> | |
| @@ -1,10 +1,13 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 1 | 2 | |
| 2 | − D-Link DL2000-based Gigabit Ethernet Adapter Installation | |
| 3 | − for Linux | |
| 4 | − May 23, 2002 | |
| 3 | +========================================================= | |
| 4 | +D-Link DL2000-based Gigabit Ethernet Adapter Installation | |
| 5 | +========================================================= | |
| 6 | + | |
| 7 | +May 23, 2002 | |
| 8 | + | |
| 9 | +.. Contents | |
| 5 | 10 | |
| 6 | −Contents | |
| 7 | −======== | |
| 8 | 11 | - Compatibility List |
| 9 | 12 | - Quick Install |
| 10 | 13 | - Compiling the Driver |
| @@ -15,12 +18,13 @@ Contents · 4 unmodified lines | ||
| 15 | 18 | |
| 16 | 19 | |
| 17 | 20 | Compatibility List |
| 18 | −================= | |
| 21 | +================== | |
| 22 | + | |
| 19 | 23 | Adapter Support: |
| 20 | 24 | |
| 21 | −D-Link DGE-550T Gigabit Ethernet Adapter. | |
| 22 | −D-Link DGE-550SX Gigabit Ethernet Adapter. | |
| 23 | −D-Link DL2000-based Gigabit Ethernet Adapter. | |
| 25 | +- D-Link DGE-550T Gigabit Ethernet Adapter. | |
| 26 | +- D-Link DGE-550SX Gigabit Ethernet Adapter. | |
| 27 | +- D-Link DL2000-based Gigabit Ethernet Adapter. | |
| 24 | 28 | |
| 25 | 29 | |
| 26 | 30 | The driver support Linux kernel 2.4.7 later. We had tested it |
| @@ -34,28 +38,32 @@ on the environments below. · 7 unmodified lines | ||
| 34 | 38 | |
| 35 | 39 | Quick Install |
| 36 | 40 | ============= |
| 37 | −Install linux driver as following command: | |
| 41 | +Install linux driver as following command:: | |
| 42 | + | |
| 43 | + 1. make all | |
| 44 | + 2. insmod dl2k.ko | |
| 45 | + 3. ifconfig eth0 up 10.xxx.xxx.xxx netmask 255.0.0.0 | |
| 46 | + ^^^^^^^^^^^^^^^\ ^^^^^^^^\ | |
| 47 | + IP NETMASK | |
| 38 | 48 | |
| 39 | −1. make all | |
| 40 | −2. insmod dl2k.ko | |
| 41 | −3. ifconfig eth0 up 10.xxx.xxx.xxx netmask 255.0.0.0 | |
| 42 | − ^^^^^^^^^^^^^^^\ ^^^^^^^^\ | |
| 43 | − IP NETMASK | |
| 44 | 49 | Now eth0 should active, you can test it by "ping" or get more information by |
| 45 | 50 | "ifconfig". If tested ok, continue the next step. |
| 46 | 51 | |
| 47 | −4. cp dl2k.ko /lib/modules/`uname -r`/kernel/drivers/net | |
| 48 | −5. Add the following line to /etc/modprobe.d/dl2k.conf: | |
| 52 | +4. ``cp dl2k.ko /lib/modules/`uname -r`/kernel/drivers/net`` | |
| 53 | +5. Add the following line to /etc/modprobe.d/dl2k.conf:: | |
| 54 | + | |
| 49 | 55 | alias eth0 dl2k |
| 50 | −6. Run depmod to updated module indexes. | |
| 51 | −7. Run "netconfig" or "netconf" to create configuration script ifcfg-eth0 | |
| 56 | + | |
| 57 | +6. Run ``depmod`` to updated module indexes. | |
| 58 | +7. Run ``netconfig`` or ``netconf`` to create configuration script ifcfg-eth0 | |
| 52 | 59 | located at /etc/sysconfig/network-scripts or create it manually. |
| 60 | + | |
| 53 | 61 | [see - Configuration Script Sample] |
| 54 | 62 | 8. Driver will automatically load and configure at next boot time. |
| 55 | 63 | |
| 56 | 64 | Compiling the Driver |
| 57 | 65 | ==================== |
| 58 | − In Linux, NIC drivers are most commonly configured as loadable modules. | |
| 66 | +In Linux, NIC drivers are most commonly configured as loadable modules. | |
| 59 | 67 | The approach of building a monolithic kernel has become obsolete. The driver |
| 60 | 68 | can be compiled as part of a monolithic kernel, but is strongly discouraged. |
| 61 | 69 | The remainder of this section assumes the driver is built as a loadable module. |
| @@ -73,93 +81,108 @@ to compile and link the driver: · 11 unmodified lines | ||
| 73 | 81 | CD-ROM drive |
| 74 | 82 | ------------ |
| 75 | 83 | |
| 76 | −[root@XXX /] mkdir cdrom | |
| 77 | −[root@XXX /] mount -r -t iso9660 -o conv=auto /dev/cdrom /cdrom | |
| 78 | −[root@XXX /] cd root | |
| 79 | −[root@XXX /root] mkdir dl2k | |
| 80 | −[root@XXX /root] cd dl2k | |
| 81 | −[root@XXX dl2k] cp /cdrom/linux/dl2k.tgz /root/dl2k | |
| 82 | −[root@XXX dl2k] tar xfvz dl2k.tgz | |
| 83 | −[root@XXX dl2k] make all | |
| 84 | +:: | |
| 85 | + | |
| 86 | + [root@XXX /] mkdir cdrom | |
| 87 | + [root@XXX /] mount -r -t iso9660 -o conv=auto /dev/cdrom /cdrom | |
| 88 | + [root@XXX /] cd root | |
| 89 | + [root@XXX /root] mkdir dl2k | |
| 90 | + [root@XXX /root] cd dl2k | |
| 91 | + [root@XXX dl2k] cp /cdrom/linux/dl2k.tgz /root/dl2k | |
| 92 | + [root@XXX dl2k] tar xfvz dl2k.tgz | |
| 93 | + [root@XXX dl2k] make all | |
| 84 | 94 | |
| 85 | 95 | Floppy disc drive |
| 86 | 96 | ----------------- |
| 87 | 97 | |
| 88 | −[root@XXX /] cd root | |
| 89 | −[root@XXX /root] mkdir dl2k | |
| 90 | −[root@XXX /root] cd dl2k | |
| 91 | −[root@XXX dl2k] mcopy a:/linux/dl2k.tgz /root/dl2k | |
| 92 | −[root@XXX dl2k] tar xfvz dl2k.tgz | |
| 93 | −[root@XXX dl2k] make all | |
| 98 | +:: | |
| 99 | + | |
| 100 | + [root@XXX /] cd root | |
| 101 | + [root@XXX /root] mkdir dl2k | |
| 102 | + [root@XXX /root] cd dl2k | |
| 103 | + [root@XXX dl2k] mcopy a:/linux/dl2k.tgz /root/dl2k | |
| 104 | + [root@XXX dl2k] tar xfvz dl2k.tgz | |
| 105 | + [root@XXX dl2k] make all | |
| 94 | 106 | |
| 95 | 107 | Installing the Driver |
| 96 | 108 | ===================== |
| 97 | 109 | |
| 98 | − Manual Installation | |
| 99 | − ------------------- | |
| 110 | +Manual Installation | |
| 111 | +------------------- | |
| 112 | + | |
| 100 | 113 | Once the driver has been compiled, it must be loaded, enabled, and bound |
| 101 | 114 | to a protocol stack in order to establish network connectivity. To load a |
| 102 | − module enter the command: | |
| 115 | + module enter the command:: | |
| 116 | + | |
| 117 | + insmod dl2k.o | |
| 118 | + | |
| 119 | + or:: | |
| 120 | + | |
| 121 | + insmod dl2k.o <optional parameter> ; add parameter | |
| 103 | 122 | |
| 104 | − insmod dl2k.o | |
| 123 | +--------------------------------------------------------- | |
| 105 | 124 | |
| 106 | − or | |
| 125 | + example:: | |
| 107 | 126 | |
| 108 | − insmod dl2k.o <optional parameter> ; add parameter | |
| 127 | + insmod dl2k.o media=100mbps_hd | |
| 109 | 128 | |
| 110 | − =============================================================== | |
| 111 | − example: insmod dl2k.o media=100mbps_hd | |
| 112 | − or insmod dl2k.o media=3 | |
| 113 | − or insmod dl2k.o media=3,2 ; for 2 cards | |
| 114 | − =============================================================== | |
| 129 | + or:: | |
| 130 | + | |
| 131 | + insmod dl2k.o media=3 | |
| 132 | + | |
| 133 | + or:: | |
| 134 | + | |
| 135 | + insmod dl2k.o media=3,2 ; for 2 cards | |
| 136 | + | |
| 137 | +--------------------------------------------------------- | |
| 115 | 138 | |
| 116 | 139 | Please reference the list of the command line parameters supported by |
| 117 | 140 | the Linux device driver below. |
| 118 | 141 | |
| 119 | 142 | The insmod command only loads the driver and gives it a name of the form |
| 120 | 143 | eth0, eth1, etc. To bring the NIC into an operational state, |
| 121 | − it is necessary to issue the following command: | |
| 144 | + it is necessary to issue the following command:: | |
| 122 | 145 | |
| 123 | − ifconfig eth0 up | |
| 146 | + ifconfig eth0 up | |
| 124 | 147 | |
| 125 | 148 | Finally, to bind the driver to the active protocol (e.g., TCP/IP with |
| 126 | − Linux), enter the following command: | |
| 149 | + Linux), enter the following command:: | |
| 127 | 150 | |
| 128 | − ifup eth0 | |
| 151 | + ifup eth0 | |
| 129 | 152 | |
| 130 | 153 | Note that this is meaningful only if the system can find a configuration |
| 131 | 154 | script that contains the necessary network information. A sample will be |
| 132 | 155 | given in the next paragraph. |
| 133 | 156 | |
| 134 | − The commands to unload a driver are as follows: | |
| 157 | + The commands to unload a driver are as follows:: | |
| 135 | 158 | |
| 136 | − ifdown eth0 | |
| 137 | − ifconfig eth0 down | |
| 138 | − rmmod dl2k.o | |
| 159 | + ifdown eth0 | |
| 160 | + ifconfig eth0 down | |
| 161 | + rmmod dl2k.o | |
| 139 | 162 | |
| 140 | 163 | The following are the commands to list the currently loaded modules and |
| 141 | − to see the current network configuration. | |
| 164 | + to see the current network configuration:: | |
| 142 | 165 | |
| 143 | − lsmod | |
| 144 | − ifconfig | |
| 166 | + lsmod | |
| 167 | + ifconfig | |
| 145 | 168 | |
| 146 | 169 | |
| 147 | − Automated Installation | |
| 148 | − ---------------------- | |
| 170 | +Automated Installation | |
| 171 | +---------------------- | |
| 149 | 172 | This section describes how to install the driver such that it is |
| 150 | 173 | automatically loaded and configured at boot time. The following description |
| 151 | 174 | is based on a Red Hat 6.0/7.0 distribution, but it can easily be ported to |
| 152 | 175 | other distributions as well. |
| 153 | 176 | |
| 154 | − Red Hat v6.x/v7.x | |
| 155 | − ----------------- | |
| 177 | +Red Hat v6.x/v7.x | |
| 178 | +----------------- | |
| 156 | 179 | 1. Copy dl2k.o to the network modules directory, typically |
| 157 | 180 | /lib/modules/2.x.x-xx/net or /lib/modules/2.x.x/kernel/drivers/net. |
| 158 | 181 | 2. Locate the boot module configuration file, most commonly in the |
| 159 | − /etc/modprobe.d/ directory. Add the following lines: | |
| 182 | + /etc/modprobe.d/ directory. Add the following lines:: | |
| 160 | 183 | |
| 161 | − alias ethx dl2k | |
| 162 | − options dl2k <optional parameters> | |
| 184 | + alias ethx dl2k | |
| 185 | + options dl2k <optional parameters> | |
| 163 | 186 | |
| 164 | 187 | where ethx will be eth0 if the NIC is the only ethernet adapter, eth1 if |
| 165 | 188 | one other ethernet adapter is installed, etc. Refer to the table in the |
| @@ -180,11 +203,15 @@ parameter. Below is a list of the command line parameters supported by the · 14 unmodified lines | ||
| 180 | 203 | Linux device |
| 181 | 204 | driver. |
| 182 | 205 | |
| 183 | −mtu=packet_size - Specifies the maximum packet size. default | |
| 206 | + | |
| 207 | +=============================== ============================================== | |
| 208 | +mtu=packet_size Specifies the maximum packet size. default | |
| 184 | 209 | is 1500. |
| 185 | 210 | |
| 186 | −media=media_type - Specifies the media type the NIC operates at. | |
| 211 | +media=media_type Specifies the media type the NIC operates at. | |
| 187 | 212 | autosense Autosensing active media. |
| 213 | + | |
| 214 | + =========== ========================= | |
| 188 | 215 | 10mbps_hd 10Mbps half duplex. |
| 189 | 216 | 10mbps_fd 10Mbps full duplex. |
| 190 | 217 | 100mbps_hd 100Mbps half duplex. |
| @@ -198,85 +225,90 @@ media=media_type - Specifies the media type the NIC operates at. · 7 unmodified lines | ||
| 198 | 225 | 4 100Mbps full duplex. |
| 199 | 226 | 5 1000Mbps half duplex. |
| 200 | 227 | 6 1000Mbps full duplex. |
| 228 | + =========== ========================= | |
| 201 | 229 | |
| 202 | 230 | By default, the NIC operates at autosense. |
| 203 | 231 | 1000mbps_fd and 1000mbps_hd types are only |
| 204 | 232 | available for fiber adapter. |
| 205 | 233 | |
| 206 | −vlan=n - Specifies the VLAN ID. If vlan=0, the | |
| 234 | +vlan=n Specifies the VLAN ID. If vlan=0, the | |
| 207 | 235 | Virtual Local Area Network (VLAN) function is |
| 208 | 236 | disable. |
| 209 | 237 | |
| 210 | −jumbo=[0|1] - Specifies the jumbo frame support. If jumbo=1, | |
| 238 | +jumbo=[0|1] Specifies the jumbo frame support. If jumbo=1, | |
| 211 | 239 | the NIC accept jumbo frames. By default, this |
| 212 | 240 | function is disabled. |
| 213 | 241 | Jumbo frame usually improve the performance |
| 214 | 242 | int gigabit. |
| 215 | − This feature need jumbo frame compatible | |
| 243 | + This feature need jumbo frame compatible | |
| 216 | 244 | remote. |
| 217 | − | |
| 218 | −rx_coalesce=m - Number of rx frame handled each interrupt. | |
| 219 | −rx_timeout=n - Rx DMA wait time for an interrupt. | |
| 220 | − If set rx_coalesce > 0, hardware only assert | |
| 221 | − an interrupt for m frames. Hardware won't | |
| 245 | + | |
| 246 | +rx_coalesce=m Number of rx frame handled each interrupt. | |
| 247 | +rx_timeout=n Rx DMA wait time for an interrupt. | |
| 248 | + If set rx_coalesce > 0, hardware only assert | |
| 249 | + an interrupt for m frames. Hardware won't | |
| 222 | 250 | assert rx interrupt until m frames received or |
| 223 | − reach timeout of n * 640 nano seconds. | |
| 224 | − Set proper rx_coalesce and rx_timeout can | |
| 251 | + reach timeout of n * 640 nano seconds. | |
| 252 | + Set proper rx_coalesce and rx_timeout can | |
| 225 | 253 | reduce congestion collapse and overload which |
| 226 | 254 | has been a bottleneck for high speed network. |
| 227 | − | |
| 255 | + | |
| 228 | 256 | For example, rx_coalesce=10 rx_timeout=800. |
| 229 | − that is, hardware assert only 1 interrupt | |
| 230 | − for 10 frames received or timeout of 512 us. | |
| 257 | + that is, hardware assert only 1 interrupt | |
| 258 | + for 10 frames received or timeout of 512 us. | |
| 231 | 259 | |
| 232 | −tx_coalesce=n - Number of tx frame handled each interrupt. | |
| 233 | − Set n > 1 can reduce the interrupts | |
| 260 | +tx_coalesce=n Number of tx frame handled each interrupt. | |
| 261 | + Set n > 1 can reduce the interrupts | |
| 234 | 262 | congestion usually lower performance of |
| 235 | 263 | high speed network card. Default is 16. |
| 236 | − | |
| 237 | −tx_flow=[1|0] - Specifies the Tx flow control. If tx_flow=0, | |
| 264 | + | |
| 265 | +tx_flow=[1|0] Specifies the Tx flow control. If tx_flow=0, | |
| 238 | 266 | the Tx flow control disable else driver |
| 239 | 267 | autodetect. |
| 240 | −rx_flow=[1|0] - Specifies the Rx flow control. If rx_flow=0, | |
| 268 | +rx_flow=[1|0] Specifies the Rx flow control. If rx_flow=0, | |
| 241 | 269 | the Rx flow control enable else driver |
| 242 | 270 | autodetect. |
| 271 | +=============================== ============================================== | |
| 243 | 272 | |
| 244 | 273 | |
| 245 | 274 | Configuration Script Sample |
| 246 | 275 | =========================== |
| 247 | −Here is a sample of a simple configuration script: | |
| 276 | +Here is a sample of a simple configuration script:: | |
| 248 | 277 | |
| 249 | −DEVICE=eth0 | |
| 250 | −USERCTL=no | |
| 251 | −ONBOOT=yes | |
| 252 | −POOTPROTO=none | |
| 253 | −BROADCAST=207.200.5.255 | |
| 254 | −NETWORK=207.200.5.0 | |
| 255 | −NETMASK=255.255.255.0 | |
| 256 | −IPADDR=207.200.5.2 | |
| 278 | + DEVICE=eth0 | |
| 279 | + USERCTL=no | |
| 280 | + ONBOOT=yes | |
| 281 | + POOTPROTO=none | |
| 282 | + BROADCAST=207.200.5.255 | |
| 283 | + NETWORK=207.200.5.0 | |
| 284 | + NETMASK=255.255.255.0 | |
| 285 | + IPADDR=207.200.5.2 | |
| 257 | 286 | |
| 258 | 287 | |
| 259 | 288 | Troubleshooting |
| 260 | 289 | =============== |
| 261 | 290 | Q1. Source files contain ^ M behind every line. |
| 262 | − Make sure all files are Unix file format (no LF). Try the following | |
| 263 | − shell command to convert files. | |
| 291 | + | |
| 292 | + Make sure all files are Unix file format (no LF). Try the following | |
| 293 | + shell command to convert files:: | |
| 264 | 294 | |
| 265 | 295 | cat dl2k.c | col -b > dl2k.tmp |
| 266 | 296 | mv dl2k.tmp dl2k.c |
| 267 | 297 | |
| 268 | − OR | |
| 298 | + OR:: | |
| 269 | 299 | |
| 270 | 300 | cat dl2k.c | tr -d "\r" > dl2k.tmp |
| 271 | 301 | mv dl2k.tmp dl2k.c |
| 272 | 302 | |
| 273 | −Q2: Could not find header files (*.h) ? | |
| 274 | − To compile the driver, you need kernel header files. After | |
| 303 | +Q2: Could not find header files (``*.h``)? | |
| 304 | + | |
| 305 | + To compile the driver, you need kernel header files. After | |
| 275 | 306 | installing the kernel source, the header files are usually located in |
| 276 | 307 | /usr/src/linux/include, which is the default include directory configured |
| 277 | 308 | in Makefile. For some distributions, there is a copy of header files in |
| 278 | 309 | /usr/src/include/linux and /usr/src/include/asm, that you can change the |
| 279 | 310 | INCLUDEDIR in Makefile to /usr/include without installing kernel source. |
| 280 | − Note that RH 7.0 didn't provide correct header files in /usr/include, | |
| 311 | + | |
| 312 | + Note that RH 7.0 didn't provide correct header files in /usr/include, | |
| 281 | 313 | including those files will make a wrong version driver. |
| 282 | 314 | |
| @@ -1,12 +1,14 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +============================== | |
| 1 | 4 | The QorIQ DPAA Ethernet Driver |
| 2 | 5 | ============================== |
| 3 | 6 | |
| 4 | 7 | Authors: |
| 5 | −Madalin Bucur <madalin.bucur@nxp.com> | |
| 6 | −Camelia Groza <camelia.groza@nxp.com> | |
| 8 | +- Madalin Bucur <madalin.bucur@nxp.com> | |
| 9 | +- Camelia Groza <camelia.groza@nxp.com> | |
| 7 | 10 | |
| 8 | −Contents | |
| 9 | −======== | |
| 11 | +.. Contents | |
| 10 | 12 | |
| 11 | 13 | - DPAA Ethernet Overview |
| 12 | 14 | - DPAA Ethernet Supported SoCs |
| @@ -34,7 +36,7 @@ following drivers in the Linux kernel: · 21 unmodified lines | ||
| 34 | 36 | - Queue Manager (QMan), Buffer Manager (BMan) |
| 35 | 37 | drivers/soc/fsl/qbman |
| 36 | 38 | |
| 37 | −A simplified view of the dpaa_eth interfaces mapped to FMan MACs: | |
| 39 | +A simplified view of the dpaa_eth interfaces mapped to FMan MACs:: | |
| 38 | 40 | |
| 39 | 41 | dpaa_eth /eth0\ ... /ethN\ |
| 40 | 42 | driver | | | | |
| @@ -42,89 +44,93 @@ A simplified view of the dpaa_eth interfaces mapped to FMan MACs: · 1 unmodified line | ||
| 42 | 44 | -Ports / Tx Rx \ ... / Tx Rx \ |
| 43 | 45 | FMan | | | | |
| 44 | 46 | -MACs | MAC0 | | MACN | |
| 45 | − / dtsec0 \ ... / dtsecN \ (or tgec) | |
| 46 | − / \ / \(or memac) | |
| 47 | + / dtsec0 \ ... / dtsecN \ (or tgec) | |
| 48 | + / \ / \(or memac) | |
| 47 | 49 | --------- -------------- --- -------------- --------- |
| 48 | 50 | FMan, FMan Port, FMan SP, FMan MURAM drivers |
| 49 | 51 | --------------------------------------------------------- |
| 50 | 52 | FMan HW blocks: MURAM, MACs, Ports, SP |
| 51 | 53 | --------------------------------------------------------- |
| 52 | 54 | |
| 53 | −The dpaa_eth relation to the QMan, BMan and FMan: | |
| 54 | − ________________________________ | |
| 55 | +The dpaa_eth relation to the QMan, BMan and FMan:: | |
| 56 | + | |
| 57 | + ________________________________ | |
| 55 | 58 | dpaa_eth / eth0 \ |
| 56 | 59 | driver / \ |
| 57 | 60 | --------- -^- -^- -^- --- --------- |
| 58 | 61 | QMan driver / \ / \ / \ \ / | BMan | |
| 59 | − |Rx | |Rx | |Tx | |Tx | | driver | | |
| 62 | + |Rx | |Rx | |Tx | |Tx | | driver | | |
| 60 | 63 | --------- |Dfl| |Err| |Cnf| |FQs| | | |
| 61 | 64 | QMan HW |FQ | |FQ | |FQs| | | | | |
| 62 | − / \ / \ / \ \ / | | | |
| 65 | + / \ / \ / \ \ / | | | |
| 63 | 66 | --------- --- --- --- -v- --------- |
| 64 | − | FMan QMI | | | |
| 65 | − | FMan HW FMan BMI | BMan HW | | |
| 66 | − ----------------------- -------- | |
| 67 | + | FMan QMI | | | |
| 68 | + | FMan HW FMan BMI | BMan HW | | |
| 69 | + ----------------------- -------- | |
| 67 | 70 | |
| 68 | 71 | where the acronyms used above (and in the code) are: |
| 69 | −DPAA = Data Path Acceleration Architecture | |
| 70 | −FMan = DPAA Frame Manager | |
| 71 | −QMan = DPAA Queue Manager | |
| 72 | −BMan = DPAA Buffers Manager | |
| 73 | −QMI = QMan interface in FMan | |
| 74 | −BMI = BMan interface in FMan | |
| 75 | −FMan SP = FMan Storage Profiles | |
| 76 | −MURAM = Multi-user RAM in FMan | |
| 77 | −FQ = QMan Frame Queue | |
| 78 | −Rx Dfl FQ = default reception FQ | |
| 79 | −Rx Err FQ = Rx error frames FQ | |
| 80 | −Tx Cnf FQ = Tx confirmation FQs | |
| 81 | −Tx FQs = transmission frame queues | |
| 82 | −dtsec = datapath three speed Ethernet controller (10/100/1000 Mbps) | |
| 83 | −tgec = ten gigabit Ethernet controller (10 Gbps) | |
| 84 | −memac = multirate Ethernet MAC (10/100/1000/10000) | |
| 72 | + | |
| 73 | +=============== =========================================================== | |
| 74 | +DPAA Data Path Acceleration Architecture | |
| 75 | +FMan DPAA Frame Manager | |
| 76 | +QMan DPAA Queue Manager | |
| 77 | +BMan DPAA Buffers Manager | |
| 78 | +QMI QMan interface in FMan | |
| 79 | +BMI BMan interface in FMan | |
| 80 | +FMan SP FMan Storage Profiles | |
| 81 | +MURAM Multi-user RAM in FMan | |
| 82 | +FQ QMan Frame Queue | |
| 83 | +Rx Dfl FQ default reception FQ | |
| 84 | +Rx Err FQ Rx error frames FQ | |
| 85 | +Tx Cnf FQ Tx confirmation FQs | |
| 86 | +Tx FQs transmission frame queues | |
| 87 | +dtsec datapath three speed Ethernet controller (10/100/1000 Mbps) | |
| 88 | +tgec ten gigabit Ethernet controller (10 Gbps) | |
| 89 | +memac multirate Ethernet MAC (10/100/1000/10000) | |
| 90 | +=============== =========================================================== | |
| 85 | 91 | |
| 86 | 92 | DPAA Ethernet Supported SoCs |
| 87 | 93 | ============================ |
| 88 | 94 | |
| 89 | 95 | The DPAA drivers enable the Ethernet controllers present on the following SoCs: |
| 90 | 96 | |
| 91 | −# PPC | |
| 92 | −P1023 | |
| 93 | −P2041 | |
| 94 | −P3041 | |
| 95 | −P4080 | |
| 96 | −P5020 | |
| 97 | −P5040 | |
| 98 | −T1023 | |
| 99 | −T1024 | |
| 100 | −T1040 | |
| 101 | −T1042 | |
| 102 | −T2080 | |
| 103 | −T4240 | |
| 104 | −B4860 | |
| 105 | − | |
| 106 | −# ARM | |
| 107 | −LS1043A | |
| 108 | −LS1046A | |
| 97 | +PPC | |
| 98 | +- P1023 | |
| 99 | +- P2041 | |
| 100 | +- P3041 | |
| 101 | +- P4080 | |
| 102 | +- P5020 | |
| 103 | +- P5040 | |
| 104 | +- T1023 | |
| 105 | +- T1024 | |
| 106 | +- T1040 | |
| 107 | +- T1042 | |
| 108 | +- T2080 | |
| 109 | +- T4240 | |
| 110 | +- B4860 | |
| 111 | + | |
| 112 | +ARM | |
| 113 | +- LS1043A | |
| 114 | +- LS1046A | |
| 109 | 115 | |
| 110 | 116 | Configuring DPAA Ethernet in your kernel |
| 111 | 117 | ======================================== |
| 112 | 118 | |
| 113 | −To enable the DPAA Ethernet driver, the following Kconfig options are required: | |
| 119 | +To enable the DPAA Ethernet driver, the following Kconfig options are required:: | |
| 114 | 120 | |
| 115 | −# common for arch/arm64 and arch/powerpc platforms | |
| 116 | −CONFIG_FSL_DPAA=y | |
| 117 | −CONFIG_FSL_FMAN=y | |
| 118 | −CONFIG_FSL_DPAA_ETH=y | |
| 119 | −CONFIG_FSL_XGMAC_MDIO=y | |
| 121 | + # common for arch/arm64 and arch/powerpc platforms | |
| 122 | + CONFIG_FSL_DPAA=y | |
| 123 | + CONFIG_FSL_FMAN=y | |
| 124 | + CONFIG_FSL_DPAA_ETH=y | |
| 125 | + CONFIG_FSL_XGMAC_MDIO=y | |
| 120 | 126 | |
| 121 | −# for arch/powerpc only | |
| 122 | −CONFIG_FSL_PAMU=y | |
| 127 | + # for arch/powerpc only | |
| 128 | + CONFIG_FSL_PAMU=y | |
| 123 | 129 | |
| 124 | −# common options needed for the PHYs used on the RDBs | |
| 125 | −CONFIG_VITESSE_PHY=y | |
| 126 | −CONFIG_REALTEK_PHY=y | |
| 127 | −CONFIG_AQUANTIA_PHY=y | |
| 130 | + # common options needed for the PHYs used on the RDBs | |
| 131 | + CONFIG_VITESSE_PHY=y | |
| 132 | + CONFIG_REALTEK_PHY=y | |
| 133 | + CONFIG_AQUANTIA_PHY=y | |
| 128 | 134 | |
| 129 | 135 | DPAA Ethernet Frame Processing |
| 130 | 136 | ============================== |
| @@ -167,7 +173,9 @@ classes as follows: · 36 unmodified lines | ||
| 167 | 173 | * priorities 8 to 11 - traffic class 2 (medium-high priority) |
| 168 | 174 | * priorities 12 to 15 - traffic class 3 (high priority) |
| 169 | 175 | |
| 170 | −tc qdisc add dev <int> root handle 1: \ | |
| 176 | +:: | |
| 177 | + | |
| 178 | + tc qdisc add dev <int> root handle 1: \ | |
| 171 | 179 | mqprio num_tc 4 map 0 0 0 0 1 1 1 1 2 2 2 2 3 3 3 3 hw 1 |
| 172 | 180 | |
| 173 | 181 | DPAA IRQ Affinity and Receive Side Scaling |
| @@ -201,11 +209,11 @@ of these frame queues will arrive at the same portal and will always · 27 unmodified lines | ||
| 201 | 209 | be processed by the same CPU. This ensures intra-flow order preservation |
| 202 | 210 | and workload distribution for multiple traffic flows. |
| 203 | 211 | |
| 204 | −RSS can be turned off for a certain interface using ethtool, i.e. | |
| 212 | +RSS can be turned off for a certain interface using ethtool, i.e.:: | |
| 205 | 213 | |
| 206 | 214 | # ethtool -N fm1-mac9 rx-flow-hash tcp4 "" |
| 207 | 215 | |
| 208 | −To turn it back on, one needs to set rx-flow-hash for tcp4/6 or udp4/6: | |
| 216 | +To turn it back on, one needs to set rx-flow-hash for tcp4/6 or udp4/6:: | |
| 209 | 217 | |
| 210 | 218 | # ethtool -N fm1-mac9 rx-flow-hash udp4 sfdn |
| 211 | 219 | |
| @@ -216,7 +224,7 @@ going to control the rx-flow-hashing for all protocols on that interface. · 4 unmodified lines | ||
| 216 | 224 | Besides using the FMan Keygen computed hash for spreading traffic on the |
| 217 | 225 | 128 Rx FQs, the DPAA Ethernet driver also sets the skb hash value when |
| 218 | 226 | the NETIF_F_RXHASH feature is on (active by default). This can be turned |
| 219 | −on or off through ethtool, i.e.: | |
| 227 | +on or off through ethtool, i.e.:: | |
| 220 | 228 | |
| 221 | 229 | # ethtool -K fm1-mac9 rx-hashing off |
| 222 | 230 | # ethtool -k fm1-mac9 | grep hash |
| @@ -246,6 +254,7 @@ The following statistics are exported for each interface through ethtool: · 23 unmodified lines | ||
| 246 | 254 | - Rx error count per CPU |
| 247 | 255 | - Rx error count per type |
| 248 | 256 | - congestion related statistics: |
| 257 | + | |
| 249 | 258 | - congestion status |
| 250 | 259 | - time spent in congestion |
| 251 | 260 | - number of time the device entered congestion |
| @@ -254,7 +263,7 @@ The following statistics are exported for each interface through ethtool: · 2 unmodified lines | ||
| 254 | 263 | The driver also exports the following information in sysfs: |
| 255 | 264 | |
| 256 | 265 | - the FQ IDs for each FQ type |
| 257 | − /sys/devices/platform/soc/<addr>.fman/<addr>.ethernet/dpaa-ethernet.<id>/net/fm<nr>-mac<nr>/fqids | |
| 266 | + /sys/devices/platform/soc/<addr>.fman/<addr>.ethernet/dpaa-ethernet.<id>/net/fm<nr>-mac<nr>/fqids | |
| 258 | 267 | |
| 259 | 268 | - the ID of the buffer pool in use |
| 260 | − /sys/devices/platform/soc/<addr>.fman/<addr>.ethernet/dpaa-ethernet.<id>/net/fm<nr>-mac<nr>/bpids | |
| 269 | + /sys/devices/platform/soc/<addr>.fman/<addr>.ethernet/dpaa-ethernet.<id>/net/fm<nr>-mac<nr>/bpids | |
| @@ -1,10 +1,15 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +=========================== | |
| 1 | 4 | The Gianfar Ethernet Driver |
| 5 | +=========================== | |
| 2 | 6 | |
| 3 | −Author: Andy Fleming <afleming@freescale.com> | |
| 4 | −Updated: 2005-07-28 | |
| 7 | +:Author: Andy Fleming <afleming@freescale.com> | |
| 8 | +:Updated: 2005-07-28 | |
| 5 | 9 | |
| 6 | 10 | |
| 7 | −CHECKSUM OFFLOADING | |
| 11 | +Checksum Offloading | |
| 12 | +=================== | |
| 8 | 13 | |
| 9 | 14 | The eTSEC controller (first included in parts from late 2005 like |
| 10 | 15 | the 8548) has the ability to perform TCP, UDP, and IP checksums |
| @@ -15,13 +20,15 @@ packets. Use ethtool to enable or disable this feature for RX · 4 unmodified lines | ||
| 15 | 20 | and TX. |
| 16 | 21 | |
| 17 | 22 | VLAN |
| 23 | +==== | |
| 18 | 24 | |
| 19 | 25 | In order to use VLAN, please consult Linux documentation on |
| 20 | 26 | configuring VLANs. The gianfar driver supports hardware insertion and |
| 21 | 27 | extraction of VLAN headers, but not filtering. Filtering will be |
| 22 | 28 | done by the kernel. |
| 23 | 29 | |
| 24 | −MULTICASTING | |
| 30 | +Multicasting | |
| 31 | +============ | |
| 25 | 32 | |
| 26 | 33 | The gianfar driver supports using the group hash table on the |
| 27 | 34 | TSEC (and the extended hash table on the eTSEC) for multicast |
| @@ -29,13 +36,15 @@ filtering. On the eTSEC, the exact-match MAC registers are used · 1 unmodified line | ||
| 29 | 36 | before the hash tables. See Linux documentation on how to join |
| 30 | 37 | multicast groups. |
| 31 | 38 | |
| 32 | −PADDING | |
| 39 | +Padding | |
| 40 | +======= | |
| 33 | 41 | |
| 34 | 42 | The gianfar driver supports padding received frames with 2 bytes |
| 35 | 43 | to align the IP header to a 16-byte boundary, when supported by |
| 36 | 44 | hardware. |
| 37 | 45 | |
| 38 | −ETHTOOL | |
| 46 | +Ethtool | |
| 47 | +======= | |
| 39 | 48 | |
| 40 | 49 | The gianfar driver supports the use of ethtool for many |
| 41 | 50 | configuration options. You must run ethtool only on currently |
| @@ -27,6 +27,30 @@ Contents: · 26 unmodified lines | ||
| 27 | 27 | netronome/nfp |
| 28 | 28 | pensando/ionic |
| 29 | 29 | stmicro/stmmac |
| 30 | + 3com/3c509 | |
| 31 | + 3com/vortex | |
| 32 | + amazon/ena | |
| 33 | + aquantia/atlantic | |
| 34 | + chelsio/cxgb | |
| 35 | + cirrus/cs89x0 | |
| 36 | + davicom/dm9000 | |
| 37 | + dec/de4x5 | |
| 38 | + dec/dmfe | |
| 39 | + dlink/dl2k | |
| 40 | + freescale/dpaa | |
| 41 | + freescale/gianfar | |
| 42 | + intel/ipw2100 | |
| 43 | + intel/ipw2200 | |
| 44 | + microsoft/netvsc | |
| 45 | + neterion/s2io | |
| 46 | + neterion/vxge | |
| 47 | + qualcomm/rmnet | |
| 48 | + sb1000 | |
| 49 | + smsc/smc9 | |
| 50 | + ti/cpsw_switchdev | |
| 51 | + ti/cpsw | |
| 52 | + ti/tlan | |
| 53 | + toshiba/spider_net | |
| 30 | 54 | |
| 31 | 55 | .. only:: subproject and html |
| 32 | 56 | |
| @@ -33,7 +33,7 @@ The following features are now available in supported kernels: · 32 unmodified lines | ||
| 33 | 33 | - SNMP |
| 34 | 34 | |
| 35 | 35 | Channel Bonding documentation can be found in the Linux kernel source: |
| 36 | −/Documentation/networking/bonding.txt | |
| 36 | +/Documentation/networking/bonding.rst | |
| 37 | 37 | |
| 38 | 38 | |
| 39 | 39 | Identifying Your Adapter |
| @@ -1,31 +1,37 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | +.. include:: <isonum.txt> | |
| 1 | 3 | |
| 2 | −Intel(R) PRO/Wireless 2100 Driver for Linux in support of: | |
| 4 | +=========================================== | |
| 5 | +Intel(R) PRO/Wireless 2100 Driver for Linux | |
| 6 | +=========================================== | |
| 3 | 7 | |
| 4 | −Intel(R) PRO/Wireless 2100 Network Connection | |
| 8 | +Support for: | |
| 5 | 9 | |
| 6 | −Copyright (C) 2003-2006, Intel Corporation | |
| 10 | +- Intel(R) PRO/Wireless 2100 Network Connection | |
| 11 | + | |
| 12 | +Copyright |copy| 2003-2006, Intel Corporation | |
| 7 | 13 | |
| 8 | 14 | README.ipw2100 |
| 9 | 15 | |
| 10 | −Version: git-1.1.5 | |
| 11 | −Date : January 25, 2006 | |
| 16 | +:Version: git-1.1.5 | |
| 17 | +:Date: January 25, 2006 | |
| 12 | 18 | |
| 13 | −Index | |
| 14 | −----------------------------------------------- | |
| 15 | −0. IMPORTANT INFORMATION BEFORE USING THIS DRIVER | |
| 16 | −1. Introduction | |
| 17 | −2. Release git-1.1.5 Current Features | |
| 18 | −3. Command Line Parameters | |
| 19 | −4. Sysfs Helper Files | |
| 20 | −5. Radio Kill Switch | |
| 21 | −6. Dynamic Firmware | |
| 22 | −7. Power Management | |
| 23 | −8. Support | |
| 24 | −9. License | |
| 19 | +.. Index | |
| 20 | + | |
| 21 | + 0. IMPORTANT INFORMATION BEFORE USING THIS DRIVER | |
| 22 | + 1. Introduction | |
| 23 | + 2. Release git-1.1.5 Current Features | |
| 24 | + 3. Command Line Parameters | |
| 25 | + 4. Sysfs Helper Files | |
| 26 | + 5. Radio Kill Switch | |
| 27 | + 6. Dynamic Firmware | |
| 28 | + 7. Power Management | |
| 29 | + 8. Support | |
| 30 | + 9. License | |
| 25 | 31 | |
| 26 | 32 | |
| 27 | −0. IMPORTANT INFORMATION BEFORE USING THIS DRIVER | |
| 28 | −----------------------------------------------- | |
| 33 | +0. IMPORTANT INFORMATION BEFORE USING THIS DRIVER | |
| 34 | +================================================= | |
| 29 | 35 | |
| 30 | 36 | Important Notice FOR ALL USERS OR DISTRIBUTORS!!!! |
| 31 | 37 | |
| @@ -75,10 +81,10 @@ obtain a tested driver from Intel Customer Support at: · 43 unmodified lines | ||
| 75 | 81 | http://www.intel.com/support/wireless/sb/CS-006408.htm |
| 76 | 82 | |
| 77 | 83 | 1. Introduction |
| 78 | −----------------------------------------------- | |
| 84 | +=============== | |
| 79 | 85 | |
| 80 | −This document provides a brief overview of the features supported by the | |
| 81 | −IPW2100 driver project. The main project website, where the latest | |
| 86 | +This document provides a brief overview of the features supported by the | |
| 87 | +IPW2100 driver project. The main project website, where the latest | |
| 82 | 88 | development version of the driver can be found, is: |
| 83 | 89 | |
| 84 | 90 | http://ipw2100.sourceforge.net |
| @@ -89,10 +95,11 @@ for the driver project. · 4 unmodified lines | ||
| 89 | 95 | |
| 90 | 96 | |
| 91 | 97 | 2. Release git-1.1.5 Current Supported Features |
| 92 | −----------------------------------------------- | |
| 98 | +=============================================== | |
| 99 | + | |
| 93 | 100 | - Managed (BSS) and Ad-Hoc (IBSS) |
| 94 | 101 | - WEP (shared key and open) |
| 95 | −- Wireless Tools support | |
| 102 | +- Wireless Tools support | |
| 96 | 103 | - 802.1x (tested with XSupplicant 1.0.1) |
| 97 | 104 | |
| 98 | 105 | Enabled (but not supported) features: |
| @@ -105,11 +112,11 @@ performed on a given feature. · 6 unmodified lines | ||
| 105 | 112 | |
| 106 | 113 | |
| 107 | 114 | 3. Command Line Parameters |
| 108 | −----------------------------------------------- | |
| 115 | +========================== | |
| 109 | 116 | |
| 110 | 117 | If the driver is built as a module, the following optional parameters are used |
| 111 | 118 | by entering them on the command line with the modprobe command using this |
| 112 | −syntax: | |
| 119 | +syntax:: | |
| 113 | 120 | |
| 114 | 121 | modprobe ipw2100 [<option>=<VAL1><,VAL2>...] |
| 115 | 122 | |
| @@ -119,61 +126,76 @@ For example, to disable the radio on driver loading, enter: · 3 unmodified lines | ||
| 119 | 126 | |
| 120 | 127 | The ipw2100 driver supports the following module parameters: |
| 121 | 128 | |
| 122 | −Name Value Example: | |
| 123 | −debug 0x0-0xffffffff debug=1024 | |
| 124 | −mode 0,1,2 mode=1 /* AdHoc */ | |
| 125 | −channel int channel=3 /* Only valid in AdHoc or Monitor */ | |
| 126 | −associate boolean associate=0 /* Do NOT auto associate */ | |
| 127 | −disable boolean disable=1 /* Do not power the HW */ | |
| 129 | +========= ============== ============ ============================== | |
| 130 | +Name Value Example Meaning | |
| 131 | +========= ============== ============ ============================== | |
| 132 | +debug 0x0-0xffffffff debug=1024 Debug level set to 1024 | |
| 133 | +mode 0,1,2 mode=1 AdHoc | |
| 134 | +channel int channel=3 Only valid in AdHoc or Monitor | |
| 135 | +associate boolean associate=0 Do NOT auto associate | |
| 136 | +disable boolean disable=1 Do not power the HW | |
| 137 | +========= ============== ============ ============================== | |
| 128 | 138 | |
| 129 | 139 | |
| 130 | 140 | 4. Sysfs Helper Files |
| 131 | −--------------------------- | |
| 132 | −----------------------------------------------- | |
| 141 | +===================== | |
| 133 | 142 | |
| 134 | −There are several ways to control the behavior of the driver. Many of the | |
| 143 | +There are several ways to control the behavior of the driver. Many of the | |
| 135 | 144 | general capabilities are exposed through the Wireless Tools (iwconfig). There |
| 136 | 145 | are a few capabilities that are exposed through entries in the Linux Sysfs. |
| 137 | 146 | |
| 138 | 147 | |
| 139 | −----- Driver Level ------ | |
| 148 | +**Driver Level** | |
| 149 | + | |
| 140 | 150 | For the driver level files, look in /sys/bus/pci/drivers/ipw2100/ |
| 141 | 151 | |
| 142 | − debug_level | |
| 143 | − | |
| 144 | − This controls the same global as the 'debug' module parameter. For | |
| 145 | − information on the various debugging levels available, run the 'dvals' | |
| 152 | + debug_level | |
| 153 | + This controls the same global as the 'debug' module parameter. For | |
| 154 | + information on the various debugging levels available, run the 'dvals' | |
| 146 | 155 | script found in the driver source directory. |
| 147 | 156 | |
| 148 | − NOTE: 'debug_level' is only enabled if CONFIG_IPW2100_DEBUG is turn | |
| 149 | − on. | |
| 157 | + .. note:: | |
| 158 | + | |
| 159 | + 'debug_level' is only enabled if CONFIG_IPW2100_DEBUG is turn on. | |
| 160 | + | |
| 161 | +**Device Level** | |
| 162 | + | |
| 163 | +For the device level files look in:: | |
| 150 | 164 | |
| 151 | −----- Device Level ------ | |
| 152 | −For the device level files look in | |
| 153 | − | |
| 154 | 165 | /sys/bus/pci/drivers/ipw2100/{PCI-ID}/ |
| 155 | 166 | |
| 156 | −For example: | |
| 167 | +For example:: | |
| 168 | + | |
| 157 | 169 | /sys/bus/pci/drivers/ipw2100/0000:02:01.0 |
| 158 | 170 | |
| 159 | 171 | For the device level files, see /sys/bus/pci/drivers/ipw2100: |
| 160 | 172 | |
| 161 | 173 | rf_kill |
| 162 | − read - | |
| 163 | − 0 = RF kill not enabled (radio on) | |
| 164 | − 1 = SW based RF kill active (radio off) | |
| 165 | − 2 = HW based RF kill active (radio off) | |
| 166 | − 3 = Both HW and SW RF kill active (radio off) | |
| 167 | − write - | |
| 168 | − 0 = If SW based RF kill active, turn the radio back on | |
| 169 | − 1 = If radio is on, activate SW based RF kill | |
| 174 | + read | |
| 175 | + | |
| 176 | + == ========================================= | |
| 177 | + 0 RF kill not enabled (radio on) | |
| 178 | + 1 SW based RF kill active (radio off) | |
| 179 | + 2 HW based RF kill active (radio off) | |
| 180 | + 3 Both HW and SW RF kill active (radio off) | |
| 181 | + == ========================================= | |
| 182 | + | |
| 183 | + write | |
| 184 | + | |
| 185 | + == ================================================== | |
| 186 | + 0 If SW based RF kill active, turn the radio back on | |
| 187 | + 1 If radio is on, activate SW based RF kill | |
| 188 | + == ================================================== | |
| 170 | 189 | |
| 171 | − NOTE: If you enable the SW based RF kill and then toggle the HW | |
| 172 | − based RF kill from ON -> OFF -> ON, the radio will NOT come back on | |
| 190 | + .. note:: | |
| 191 | + | |
| 192 | + If you enable the SW based RF kill and then toggle the HW | |
| 193 | + based RF kill from ON -> OFF -> ON, the radio will NOT come back on | |
| 173 | 194 | |
| 174 | 195 | |
| 175 | 196 | 5. Radio Kill Switch |
| 176 | −----------------------------------------------- | |
| 197 | +==================== | |
| 198 | + | |
| 177 | 199 | Most laptops provide the ability for the user to physically disable the radio. |
| 178 | 200 | Some vendors have implemented this as a physical switch that requires no |
| 179 | 201 | software to turn the radio off and on. On other laptops, however, the switch |
| @@ -186,9 +208,10 @@ on your system. · 6 unmodified lines | ||
| 186 | 208 | |
| 187 | 209 | |
| 188 | 210 | 6. Dynamic Firmware |
| 189 | −----------------------------------------------- | |
| 190 | −As the firmware is licensed under a restricted use license, it can not be | |
| 191 | −included within the kernel sources. To enable the IPW2100 you will need a | |
| 211 | +=================== | |
| 212 | + | |
| 213 | +As the firmware is licensed under a restricted use license, it can not be | |
| 214 | +included within the kernel sources. To enable the IPW2100 you will need a | |
| 192 | 215 | firmware image to load into the wireless NIC's processors. |
| 193 | 216 | |
| 194 | 217 | You can obtain these images from <http://ipw2100.sf.net/firmware.php>. |
| @@ -197,52 +220,57 @@ See INSTALL for instructions on installing the firmware. · 2 unmodified lines | ||
| 197 | 220 | |
| 198 | 221 | |
| 199 | 222 | 7. Power Management |
| 200 | −----------------------------------------------- | |
| 201 | −The IPW2100 supports the configuration of the Power Save Protocol | |
| 202 | −through a private wireless extension interface. The IPW2100 supports | |
| 223 | +=================== | |
| 224 | + | |
| 225 | +The IPW2100 supports the configuration of the Power Save Protocol | |
| 226 | +through a private wireless extension interface. The IPW2100 supports | |
| 203 | 227 | the following different modes: |
| 204 | 228 | |
| 229 | + === =========================================================== | |
| 205 | 230 | off No power management. Radio is always on. |
| 206 | 231 | on Automatic power management |
| 207 | − 1-5 Different levels of power management. The higher the | |
| 208 | − number the greater the power savings, but with an impact to | |
| 209 | − packet latencies. | |
| 210 | − | |
| 211 | −Power management works by powering down the radio after a certain | |
| 212 | −interval of time has passed where no packets are passed through the | |
| 213 | −radio. Once powered down, the radio remains in that state for a given | |
| 214 | −period of time. For higher power savings, the interval between last | |
| 232 | + 1-5 Different levels of power management. The higher the | |
| 233 | + number the greater the power savings, but with an impact to | |
| 234 | + packet latencies. | |
| 235 | + === =========================================================== | |
| 236 | + | |
| 237 | +Power management works by powering down the radio after a certain | |
| 238 | +interval of time has passed where no packets are passed through the | |
| 239 | +radio. Once powered down, the radio remains in that state for a given | |
| 240 | +period of time. For higher power savings, the interval between last | |
| 215 | 241 | packet processed to sleep is shorter and the sleep period is longer. |
| 216 | 242 | |
| 217 | −When the radio is asleep, the access point sending data to the station | |
| 218 | −must buffer packets at the AP until the station wakes up and requests | |
| 219 | −any buffered packets. If you have an AP that does not correctly support | |
| 220 | −the PSP protocol you may experience packet loss or very poor performance | |
| 221 | −while power management is enabled. If this is the case, you will need | |
| 222 | −to try and find a firmware update for your AP, or disable power | |
| 223 | −management (via `iwconfig eth1 power off`) | |
| 243 | +When the radio is asleep, the access point sending data to the station | |
| 244 | +must buffer packets at the AP until the station wakes up and requests | |
| 245 | +any buffered packets. If you have an AP that does not correctly support | |
| 246 | +the PSP protocol you may experience packet loss or very poor performance | |
| 247 | +while power management is enabled. If this is the case, you will need | |
| 248 | +to try and find a firmware update for your AP, or disable power | |
| 249 | +management (via ``iwconfig eth1 power off``) | |
| 224 | 250 | |
| 225 | −To configure the power level on the IPW2100 you use a combination of | |
| 226 | −iwconfig and iwpriv. iwconfig is used to turn power management on, off, | |
| 251 | +To configure the power level on the IPW2100 you use a combination of | |
| 252 | +iwconfig and iwpriv. iwconfig is used to turn power management on, off, | |
| 227 | 253 | and set it to auto. |
| 228 | 254 | |
| 255 | + ========================= ==================================== | |
| 229 | 256 | iwconfig eth1 power off Disables radio power down |
| 230 | − iwconfig eth1 power on Enables radio power management to | |
| 257 | + iwconfig eth1 power on Enables radio power management to | |
| 231 | 258 | last set level (defaults to AUTO) |
| 232 | − iwpriv eth1 set_power 0 Sets power level to AUTO and enables | |
| 233 | − power management if not previously | |
| 259 | + iwpriv eth1 set_power 0 Sets power level to AUTO and enables | |
| 260 | + power management if not previously | |
| 234 | 261 | enabled. |
| 235 | − iwpriv eth1 set_power 1-5 Set the power level as specified, | |
| 236 | − enabling power management if not | |
| 262 | + iwpriv eth1 set_power 1-5 Set the power level as specified, | |
| 263 | + enabling power management if not | |
| 237 | 264 | previously enabled. |
| 265 | + ========================= ==================================== | |
| 266 | + | |
| 267 | +You can view the current power level setting via:: | |
| 238 | 268 | |
| 239 | −You can view the current power level setting via: | |
| 240 | − | |
| 241 | 269 | iwpriv eth1 get_power |
| 242 | 270 | |
| 243 | 271 | It will return the current period or timeout that is configured as a string |
| 244 | 272 | in the form of xxxx/yyyy (z) where xxxx is the timeout interval (amount of |
| 245 | −time after packet processing), yyyy is the period to sleep (amount of time to | |
| 273 | +time after packet processing), yyyy is the period to sleep (amount of time to | |
| 246 | 274 | wait before powering the radio and querying the access point for buffered |
| 247 | 275 | packets), and z is the 'power level'. If power management is turned off the |
| 248 | 276 | xxxx/yyyy will be replaced with 'off' -- the level reported will be the active |
| @@ -250,44 +278,46 @@ level if `iwconfig eth1 power on` is invoked. · 1 unmodified line | ||
| 250 | 278 | |
| 251 | 279 | |
| 252 | 280 | 8. Support |
| 253 | −----------------------------------------------- | |
| 281 | +========== | |
| 254 | 282 | |
| 255 | 283 | For general development information and support, |
| 256 | 284 | go to: |
| 257 | − | |
| 285 | + | |
| 258 | 286 | http://ipw2100.sf.net/ |
| 259 | 287 | |
| 260 | −The ipw2100 1.1.0 driver and firmware can be downloaded from: | |
| 288 | +The ipw2100 1.1.0 driver and firmware can be downloaded from: | |
| 261 | 289 | |
| 262 | 290 | http://support.intel.com |
| 263 | 291 | |
| 264 | −For installation support on the ipw2100 1.1.0 driver on Linux kernels | |
| 265 | −2.6.8 or greater, email support is available from: | |
| 292 | +For installation support on the ipw2100 1.1.0 driver on Linux kernels | |
| 293 | +2.6.8 or greater, email support is available from: | |
| 266 | 294 | |
| 267 | 295 | http://supportmail.intel.com |
| 268 | 296 | |
| 269 | 297 | 9. License |
| 270 | −----------------------------------------------- | |
| 298 | +========== | |
| 271 | 299 | |
| 272 | − Copyright(c) 2003 - 2006 Intel Corporation. All rights reserved. | |
| 300 | + Copyright |copy| 2003 - 2006 Intel Corporation. All rights reserved. | |
| 273 | 301 | |
| 274 | − This program is free software; you can redistribute it and/or modify it | |
| 275 | − under the terms of the GNU General Public License (version 2) as | |
| 302 | + This program is free software; you can redistribute it and/or modify it | |
| 303 | + under the terms of the GNU General Public License (version 2) as | |
| 276 | 304 | published by the Free Software Foundation. |
| 277 | − | |
| 278 | − This program is distributed in the hope that it will be useful, but WITHOUT | |
| 279 | − ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 280 | − FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for | |
| 305 | + | |
| 306 | + This program is distributed in the hope that it will be useful, but WITHOUT | |
| 307 | + ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 308 | + FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for | |
| 281 | 309 | more details. |
| 282 | − | |
| 310 | + | |
| 283 | 311 | You should have received a copy of the GNU General Public License along with |
| 284 | − this program; if not, write to the Free Software Foundation, Inc., 59 | |
| 312 | + this program; if not, write to the Free Software Foundation, Inc., 59 | |
| 285 | 313 | Temple Place - Suite 330, Boston, MA 02111-1307, USA. |
| 286 | − | |
| 314 | + | |
| 287 | 315 | The full GNU General Public License is included in this distribution in the |
| 288 | 316 | file called LICENSE. |
| 289 | − | |
| 317 | + | |
| 290 | 318 | License Contact Information: |
| 319 | + | |
| 291 | 320 | James P. Ketrenos <ipw2100-admin@linux.intel.com> |
| 321 | + | |
| 292 | 322 | Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497 |
| 293 | 323 | |
| @@ -1,8 +1,15 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | +.. include:: <isonum.txt> | |
| 1 | 3 | |
| 2 | −Intel(R) PRO/Wireless 2915ABG Driver for Linux in support of: | |
| 4 | +============================================== | |
| 5 | +Intel(R) PRO/Wireless 2915ABG Driver for Linux | |
| 6 | +============================================== | |
| 3 | 7 | |
| 4 | −Intel(R) PRO/Wireless 2200BG Network Connection | |
| 5 | −Intel(R) PRO/Wireless 2915ABG Network Connection | |
| 8 | + | |
| 9 | +Support for: | |
| 10 | + | |
| 11 | +- Intel(R) PRO/Wireless 2200BG Network Connection | |
| 12 | +- Intel(R) PRO/Wireless 2915ABG Network Connection | |
| 6 | 13 | |
| 7 | 14 | Note: The Intel(R) PRO/Wireless 2915ABG Driver for Linux and Intel(R) |
| 8 | 15 | PRO/Wireless 2200BG Driver for Linux is a unified driver that works on |
| @@ -10,37 +17,37 @@ both hardware adapters listed above. In this document the Intel(R) · 1 unmodified line | ||
| 10 | 17 | PRO/Wireless 2915ABG Driver for Linux will be used to reference the |
| 11 | 18 | unified driver. |
| 12 | 19 | |
| 13 | −Copyright (C) 2004-2006, Intel Corporation | |
| 20 | +Copyright |copy| 2004-2006, Intel Corporation | |
| 14 | 21 | |
| 15 | 22 | README.ipw2200 |
| 16 | 23 | |
| 17 | −Version: 1.1.2 | |
| 18 | −Date : March 30, 2006 | |
| 24 | +:Version: 1.1.2 | |
| 25 | +:Date: March 30, 2006 | |
| 19 | 26 | |
| 20 | 27 | |
| 21 | −Index | |
| 22 | −----------------------------------------------- | |
| 23 | −0. IMPORTANT INFORMATION BEFORE USING THIS DRIVER | |
| 24 | −1. Introduction | |
| 25 | −1.1. Overview of features | |
| 26 | −1.2. Module parameters | |
| 27 | −1.3. Wireless Extension Private Methods | |
| 28 | −1.4. Sysfs Helper Files | |
| 29 | −1.5. Supported channels | |
| 30 | −2. Ad-Hoc Networking | |
| 31 | −3. Interacting with Wireless Tools | |
| 32 | −3.1. iwconfig mode | |
| 33 | −3.2. iwconfig sens | |
| 34 | −4. About the Version Numbers | |
| 35 | −5. Firmware installation | |
| 36 | −6. Support | |
| 37 | −7. License | |
| 28 | +.. Index | |
| 38 | 29 | |
| 30 | + 0. IMPORTANT INFORMATION BEFORE USING THIS DRIVER | |
| 31 | + 1. Introduction | |
| 32 | + 1.1. Overview of features | |
| 33 | + 1.2. Module parameters | |
| 34 | + 1.3. Wireless Extension Private Methods | |
| 35 | + 1.4. Sysfs Helper Files | |
| 36 | + 1.5. Supported channels | |
| 37 | + 2. Ad-Hoc Networking | |
| 38 | + 3. Interacting with Wireless Tools | |
| 39 | + 3.1. iwconfig mode | |
| 40 | + 3.2. iwconfig sens | |
| 41 | + 4. About the Version Numbers | |
| 42 | + 5. Firmware installation | |
| 43 | + 6. Support | |
| 44 | + 7. License | |
| 39 | 45 | |
| 40 | −0. IMPORTANT INFORMATION BEFORE USING THIS DRIVER | |
| 41 | −----------------------------------------------- | |
| 42 | 46 | |
| 43 | −Important Notice FOR ALL USERS OR DISTRIBUTORS!!!! | |
| 47 | +0. IMPORTANT INFORMATION BEFORE USING THIS DRIVER | |
| 48 | +================================================= | |
| 49 | + | |
| 50 | +Important Notice FOR ALL USERS OR DISTRIBUTORS!!!! | |
| 44 | 51 | |
| 45 | 52 | Intel wireless LAN adapters are engineered, manufactured, tested, and |
| 46 | 53 | quality checked to ensure that they meet all necessary local and |
| @@ -56,7 +63,7 @@ product is granted. Intel's wireless LAN's EEPROM, firmware, and · 9 unmodified lines | ||
| 56 | 63 | software driver are designed to carefully control parameters that affect |
| 57 | 64 | radio operation and to ensure electromagnetic compliance (EMC). These |
| 58 | 65 | parameters include, without limitation, RF power, spectrum usage, |
| 59 | −channel scanning, and human exposure. | |
| 66 | +channel scanning, and human exposure. | |
| 60 | 67 | |
| 61 | 68 | For these reasons Intel cannot permit any manipulation by third parties |
| 62 | 69 | of the software provided in binary format with the wireless WLAN |
| @@ -70,7 +77,7 @@ no liability, under any theory of liability for any issues associated · 7 unmodified lines | ||
| 70 | 77 | with the modified products, including without limitation, claims under |
| 71 | 78 | the warranty and/or issues arising from regulatory non-compliance, and |
| 72 | 79 | (iii) Intel will not provide or be required to assist in providing |
| 73 | −support to any third parties for such modified products. | |
| 80 | +support to any third parties for such modified products. | |
| 74 | 81 | |
| 75 | 82 | Note: Many regulatory agencies consider Wireless LAN adapters to be |
| 76 | 83 | modules, and accordingly, condition system-level regulatory approval |
| @@ -78,23 +85,24 @@ upon receipt and review of test data documenting that the antennas and · 1 unmodified line | ||
| 78 | 85 | system configuration do not cause the EMC and radio operation to be |
| 79 | 86 | non-compliant. |
| 80 | 87 | |
| 81 | −The drivers available for download from SourceForge are provided as a | |
| 82 | −part of a development project. Conformance to local regulatory | |
| 83 | −requirements is the responsibility of the individual developer. As | |
| 84 | −such, if you are interested in deploying or shipping a driver as part of | |
| 85 | −solution intended to be used for purposes other than development, please | |
| 88 | +The drivers available for download from SourceForge are provided as a | |
| 89 | +part of a development project. Conformance to local regulatory | |
| 90 | +requirements is the responsibility of the individual developer. As | |
| 91 | +such, if you are interested in deploying or shipping a driver as part of | |
| 92 | +solution intended to be used for purposes other than development, please | |
| 86 | 93 | obtain a tested driver from Intel Customer Support at: |
| 87 | 94 | |
| 88 | 95 | http://support.intel.com |
| 89 | 96 | |
| 90 | 97 | |
| 91 | −1. Introduction | |
| 92 | −----------------------------------------------- | |
| 93 | −The following sections attempt to provide a brief introduction to using | |
| 98 | +1. Introduction | |
| 99 | +=============== | |
| 100 | + | |
| 101 | +The following sections attempt to provide a brief introduction to using | |
| 94 | 102 | the Intel(R) PRO/Wireless 2915ABG Driver for Linux. |
| 95 | 103 | |
| 96 | −This document is not meant to be a comprehensive manual on | |
| 97 | −understanding or using wireless technologies, but should be sufficient | |
| 104 | +This document is not meant to be a comprehensive manual on | |
| 105 | +understanding or using wireless technologies, but should be sufficient | |
| 98 | 106 | to get you moving without wires on Linux. |
| 99 | 107 | |
| 100 | 108 | For information on building and installing the driver, see the INSTALL |
| @@ -102,14 +110,14 @@ file. · 1 unmodified line | ||
| 102 | 110 | |
| 103 | 111 | |
| 104 | 112 | 1.1. Overview of Features |
| 105 | −----------------------------------------------- | |
| 113 | +------------------------- | |
| 106 | 114 | The current release (1.1.2) supports the following features: |
| 107 | 115 | |
| 108 | 116 | + BSS mode (Infrastructure, Managed) |
| 109 | 117 | + IBSS mode (Ad-Hoc) |
| 110 | 118 | + WEP (OPEN and SHARED KEY mode) |
| 111 | 119 | + 802.1x EAP via wpa_supplicant and xsupplicant |
| 112 | −+ Wireless Extension support | |
| 120 | ++ Wireless Extension support | |
| 113 | 121 | + Full B and G rate support (2200 and 2915) |
| 114 | 122 | + Full A rate support (2915 only) |
| 115 | 123 | + Transmit power control |
| @@ -122,102 +130,107 @@ supported: · 6 unmodified lines | ||
| 122 | 130 | + long/short preamble support |
| 123 | 131 | + Monitor mode (aka RFMon) |
| 124 | 132 | |
| 125 | −The distinction between officially supported and enabled is a reflection | |
| 133 | +The distinction between officially supported and enabled is a reflection | |
| 126 | 134 | on the amount of validation and interoperability testing that has been |
| 127 | −performed on a given feature. | |
| 135 | +performed on a given feature. | |
| 128 | 136 | |
| 129 | 137 | |
| 130 | 138 | |
| 131 | 139 | 1.2. Command Line Parameters |
| 132 | −----------------------------------------------- | |
| 140 | +---------------------------- | |
| 133 | 141 | |
| 134 | 142 | Like many modules used in the Linux kernel, the Intel(R) PRO/Wireless |
| 135 | −2915ABG Driver for Linux allows configuration options to be provided | |
| 136 | −as module parameters. The most common way to specify a module parameter | |
| 137 | −is via the command line. | |
| 143 | +2915ABG Driver for Linux allows configuration options to be provided | |
| 144 | +as module parameters. The most common way to specify a module parameter | |
| 145 | +is via the command line. | |
| 138 | 146 | |
| 139 | −The general form is: | |
| 147 | +The general form is:: | |
| 140 | 148 | |
| 141 | −% modprobe ipw2200 parameter=value | |
| 149 | + % modprobe ipw2200 parameter=value | |
| 142 | 150 | |
| 143 | 151 | Where the supported parameter are: |
| 144 | 152 | |
| 145 | 153 | associate |
| 146 | 154 | Set to 0 to disable the auto scan-and-associate functionality of the |
| 147 | − driver. If disabled, the driver will not attempt to scan | |
| 148 | − for and associate to a network until it has been configured with | |
| 149 | − one or more properties for the target network, for example configuring | |
| 155 | + driver. If disabled, the driver will not attempt to scan | |
| 156 | + for and associate to a network until it has been configured with | |
| 157 | + one or more properties for the target network, for example configuring | |
| 150 | 158 | the network SSID. Default is 0 (do not auto-associate) |
| 151 | − | |
| 159 | + | |
| 152 | 160 | Example: % modprobe ipw2200 associate=0 |
| 153 | 161 | |
| 154 | 162 | auto_create |
| 155 | − Set to 0 to disable the auto creation of an Ad-Hoc network | |
| 156 | − matching the channel and network name parameters provided. | |
| 163 | + Set to 0 to disable the auto creation of an Ad-Hoc network | |
| 164 | + matching the channel and network name parameters provided. | |
| 157 | 165 | Default is 1. |
| 158 | 166 | |
| 159 | 167 | channel |
| 160 | 168 | channel number for association. The normal method for setting |
| 161 | − the channel would be to use the standard wireless tools | |
| 162 | − (i.e. `iwconfig eth1 channel 10`), but it is useful sometimes | |
| 169 | + the channel would be to use the standard wireless tools | |
| 170 | + (i.e. `iwconfig eth1 channel 10`), but it is useful sometimes | |
| 163 | 171 | to set this while debugging. Channel 0 means 'ANY' |
| 164 | 172 | |
| 165 | 173 | debug |
| 166 | 174 | If using a debug build, this is used to control the amount of debug |
| 167 | 175 | info is logged. See the 'dvals' and 'load' script for more info on |
| 168 | − how to use this (the dvals and load scripts are provided as part | |
| 169 | − of the ipw2200 development snapshot releases available from the | |
| 176 | + how to use this (the dvals and load scripts are provided as part | |
| 177 | + of the ipw2200 development snapshot releases available from the | |
| 170 | 178 | SourceForge project at http://ipw2200.sf.net) |
| 171 | − | |
| 179 | + | |
| 172 | 180 | led |
| 173 | 181 | Can be used to turn on experimental LED code. |
| 174 | 182 | 0 = Off, 1 = On. Default is 1. |
| 175 | 183 | |
| 176 | 184 | mode |
| 177 | − Can be used to set the default mode of the adapter. | |
| 185 | + Can be used to set the default mode of the adapter. | |
| 178 | 186 | 0 = Managed, 1 = Ad-Hoc, 2 = Monitor |
| 179 | 187 | |
| 180 | 188 | |
| 181 | 189 | 1.3. Wireless Extension Private Methods |
| 182 | −----------------------------------------------- | |
| 190 | +--------------------------------------- | |
| 183 | 191 | |
| 184 | −As an interface designed to handle generic hardware, there are certain | |
| 185 | −capabilities not exposed through the normal Wireless Tool interface. As | |
| 186 | −such, a provision is provided for a driver to declare custom, or | |
| 187 | −private, methods. The Intel(R) PRO/Wireless 2915ABG Driver for Linux | |
| 192 | +As an interface designed to handle generic hardware, there are certain | |
| 193 | +capabilities not exposed through the normal Wireless Tool interface. As | |
| 194 | +such, a provision is provided for a driver to declare custom, or | |
| 195 | +private, methods. The Intel(R) PRO/Wireless 2915ABG Driver for Linux | |
| 188 | 196 | defines several of these to configure various settings. |
| 189 | 197 | |
| 190 | −The general form of using the private wireless methods is: | |
| 198 | +The general form of using the private wireless methods is:: | |
| 191 | 199 | |
| 192 | 200 | % iwpriv $IFNAME method parameters |
| 193 | 201 | |
| 194 | −Where $IFNAME is the interface name the device is registered with | |
| 202 | +Where $IFNAME is the interface name the device is registered with | |
| 195 | 203 | (typically eth1, customized via one of the various network interface |
| 196 | 204 | name managers, such as ifrename) |
| 197 | 205 | |
| 198 | 206 | The supported private methods are: |
| 199 | 207 | |
| 200 | 208 | get_mode |
| 201 | − Can be used to report out which IEEE mode the driver is | |
| 209 | + Can be used to report out which IEEE mode the driver is | |
| 202 | 210 | configured to support. Example: |
| 203 | − | |
| 211 | + | |
| 204 | 212 | % iwpriv eth1 get_mode |
| 205 | 213 | eth1 get_mode:802.11bg (6) |
| 206 | 214 | |
| 207 | 215 | set_mode |
| 208 | − Can be used to configure which IEEE mode the driver will | |
| 209 | − support. | |
| 216 | + Can be used to configure which IEEE mode the driver will | |
| 217 | + support. | |
| 218 | + | |
| 219 | + Usage:: | |
| 220 | + | |
| 221 | + % iwpriv eth1 set_mode {mode} | |
| 210 | 222 | |
| 211 | − Usage: | |
| 212 | − % iwpriv eth1 set_mode {mode} | |
| 213 | 223 | Where {mode} is a number in the range 1-7: |
| 224 | + | |
| 225 | + == ===================== | |
| 214 | 226 | 1 802.11a (2915 only) |
| 215 | 227 | 2 802.11b |
| 216 | 228 | 3 802.11ab (2915 only) |
| 217 | − 4 802.11g | |
| 229 | + 4 802.11g | |
| 218 | 230 | 5 802.11ag (2915 only) |
| 219 | 231 | 6 802.11bg |
| 220 | 232 | 7 802.11abg (2915 only) |
| 233 | + == ===================== | |
| 221 | 234 | |
| 222 | 235 | get_preamble |
| 223 | 236 | Can be used to report configuration of preamble length. |
| @@ -225,99 +238,123 @@ The supported private methods are: · 1 unmodified line | ||
| 225 | 238 | set_preamble |
| 226 | 239 | Can be used to set the configuration of preamble length: |
| 227 | 240 | |
| 228 | − Usage: | |
| 229 | − % iwpriv eth1 set_preamble {mode} | |
| 241 | + Usage:: | |
| 242 | + | |
| 243 | + % iwpriv eth1 set_preamble {mode} | |
| 244 | + | |
| 230 | 245 | Where {mode} is one of: |
| 246 | + | |
| 247 | + == ======================================== | |
| 231 | 248 | 1 Long preamble only |
| 232 | 249 | 0 Auto (long or short based on connection) |
| 233 | − | |
| 250 | + == ======================================== | |
| 251 | + | |
| 234 | 252 | |
| 235 | −1.4. Sysfs Helper Files: | |
| 236 | −----------------------------------------------- | |
| 253 | +1.4. Sysfs Helper Files | |
| 254 | +----------------------- | |
| 237 | 255 | |
| 238 | −The Linux kernel provides a pseudo file system that can be used to | |
| 256 | +The Linux kernel provides a pseudo file system that can be used to | |
| 239 | 257 | access various components of the operating system. The Intel(R) |
| 240 | 258 | PRO/Wireless 2915ABG Driver for Linux exposes several configuration |
| 241 | 259 | parameters through this mechanism. |
| 242 | 260 | |
| 243 | −An entry in the sysfs can support reading and/or writing. You can | |
| 244 | −typically query the contents of a sysfs entry through the use of cat, | |
| 245 | −and can set the contents via echo. For example: | |
| 261 | +An entry in the sysfs can support reading and/or writing. You can | |
| 262 | +typically query the contents of a sysfs entry through the use of cat, | |
| 263 | +and can set the contents via echo. For example:: | |
| 246 | 264 | |
| 247 | −% cat /sys/bus/pci/drivers/ipw2200/debug_level | |
| 265 | + % cat /sys/bus/pci/drivers/ipw2200/debug_level | |
| 248 | 266 | |
| 249 | −Will report the current debug level of the driver's logging subsystem | |
| 267 | +Will report the current debug level of the driver's logging subsystem | |
| 250 | 268 | (only available if CONFIG_IPW2200_DEBUG was configured when the driver |
| 251 | 269 | was built). |
| 252 | 270 | |
| 253 | −You can set the debug level via: | |
| 271 | +You can set the debug level via:: | |
| 254 | 272 | |
| 255 | −% echo $VALUE > /sys/bus/pci/drivers/ipw2200/debug_level | |
| 273 | + % echo $VALUE > /sys/bus/pci/drivers/ipw2200/debug_level | |
| 256 | 274 | |
| 257 | −Where $VALUE would be a number in the case of this sysfs entry. The | |
| 258 | −input to sysfs files does not have to be a number. For example, the | |
| 259 | −firmware loader used by hotplug utilizes sysfs entries for transferring | |
| 275 | +Where $VALUE would be a number in the case of this sysfs entry. The | |
| 276 | +input to sysfs files does not have to be a number. For example, the | |
| 277 | +firmware loader used by hotplug utilizes sysfs entries for transferring | |
| 260 | 278 | the firmware image from user space into the driver. |
| 261 | 279 | |
| 262 | −The Intel(R) PRO/Wireless 2915ABG Driver for Linux exposes sysfs entries | |
| 263 | −at two levels -- driver level, which apply to all instances of the driver | |
| 264 | −(in the event that there are more than one device installed) and device | |
| 280 | +The Intel(R) PRO/Wireless 2915ABG Driver for Linux exposes sysfs entries | |
| 281 | +at two levels -- driver level, which apply to all instances of the driver | |
| 282 | +(in the event that there are more than one device installed) and device | |
| 265 | 283 | level, which applies only to the single specific instance. |
| 266 | 284 | |
| 267 | 285 | |
| 268 | 286 | 1.4.1 Driver Level Sysfs Helper Files |
| 269 | −----------------------------------------------- | |
| 287 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 270 | 288 | |
| 271 | 289 | For the driver level files, look in /sys/bus/pci/drivers/ipw2200/ |
| 272 | 290 | |
| 273 | − debug_level | |
| 274 | − | |
| 291 | + debug_level | |
| 275 | 292 | This controls the same global as the 'debug' module parameter |
| 276 | 293 | |
| 277 | 294 | |
| 278 | 295 | |
| 279 | 296 | 1.4.2 Device Level Sysfs Helper Files |
| 280 | −----------------------------------------------- | |
| 297 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 298 | + | |
| 299 | +For the device level files, look in:: | |
| 281 | 300 | |
| 282 | −For the device level files, look in | |
| 283 | − | |
| 284 | 301 | /sys/bus/pci/drivers/ipw2200/{PCI-ID}/ |
| 285 | 302 | |
| 286 | −For example: | |
| 303 | +For example::: | |
| 304 | + | |
| 287 | 305 | /sys/bus/pci/drivers/ipw2200/0000:02:01.0 |
| 288 | 306 | |
| 289 | 307 | For the device level files, see /sys/bus/pci/drivers/ipw2200: |
| 290 | 308 | |
| 291 | 309 | rf_kill |
| 292 | − read - | |
| 293 | − 0 = RF kill not enabled (radio on) | |
| 294 | − 1 = SW based RF kill active (radio off) | |
| 295 | − 2 = HW based RF kill active (radio off) | |
| 296 | − 3 = Both HW and SW RF kill active (radio off) | |
| 310 | + read - | |
| 311 | + | |
| 312 | + == ========================================= | |
| 313 | + 0 RF kill not enabled (radio on) | |
| 314 | + 1 SW based RF kill active (radio off) | |
| 315 | + 2 HW based RF kill active (radio off) | |
| 316 | + 3 Both HW and SW RF kill active (radio off) | |
| 317 | + == ========================================= | |
| 318 | + | |
| 297 | 319 | write - |
| 298 | − 0 = If SW based RF kill active, turn the radio back on | |
| 299 | − 1 = If radio is on, activate SW based RF kill | |
| 300 | 320 | |
| 301 | − NOTE: If you enable the SW based RF kill and then toggle the HW | |
| 302 | − based RF kill from ON -> OFF -> ON, the radio will NOT come back on | |
| 303 | − | |
| 304 | − ucode | |
| 321 | + == ================================================== | |
| 322 | + 0 If SW based RF kill active, turn the radio back on | |
| 323 | + 1 If radio is on, activate SW based RF kill | |
| 324 | + == ================================================== | |
| 325 | + | |
| 326 | + .. note:: | |
| 327 | + | |
| 328 | + If you enable the SW based RF kill and then toggle the HW | |
| 329 | + based RF kill from ON -> OFF -> ON, the radio will NOT come back on | |
| 330 | + | |
| 331 | + ucode | |
| 305 | 332 | read-only access to the ucode version number |
| 306 | 333 | |
| 307 | 334 | led |
| 308 | 335 | read - |
| 309 | − 0 = LED code disabled | |
| 310 | − 1 = LED code enabled | |
| 336 | + | |
| 337 | + == ================= | |
| 338 | + 0 LED code disabled | |
| 339 | + 1 LED code enabled | |
| 340 | + == ================= | |
| 341 | + | |
| 311 | 342 | write - |
| 312 | − 0 = Disable LED code | |
| 313 | − 1 = Enable LED code | |
| 314 | 343 | |
| 315 | − NOTE: The LED code has been reported to hang some systems when | |
| 316 | − running ifconfig and is therefore disabled by default. | |
| 344 | + == ================ | |
| 345 | + 0 Disable LED code | |
| 346 | + 1 Enable LED code | |
| 347 | + == ================ | |
| 348 | + | |
| 349 | + | |
| 350 | + .. note:: | |
| 351 | + | |
| 352 | + The LED code has been reported to hang some systems when | |
| 353 | + running ifconfig and is therefore disabled by default. | |
| 317 | 354 | |
| 318 | 355 | |
| 319 | 356 | 1.5. Supported channels |
| 320 | −----------------------------------------------- | |
| 357 | +----------------------- | |
| 321 | 358 | |
| 322 | 359 | Upon loading the Intel(R) PRO/Wireless 2915ABG Driver for Linux, a |
| 323 | 360 | message stating the detected geography code and the number of 802.11 |
| @@ -326,44 +363,59 @@ channels supported by the card will be displayed in the log. · 2 unmodified lines | ||
| 326 | 363 | The geography code corresponds to a regulatory domain as shown in the |
| 327 | 364 | table below. |
| 328 | 365 | |
| 329 | − Supported channels | |
| 330 | −Code Geography 802.11bg 802.11a | |
| 331 | − | |
| 332 | −--- Restricted 11 0 | |
| 333 | −ZZF Custom US/Canada 11 8 | |
| 334 | −ZZD Rest of World 13 0 | |
| 335 | −ZZA Custom USA & Europe & High 11 13 | |
| 336 | −ZZB Custom NA & Europe 11 13 | |
| 337 | −ZZC Custom Japan 11 4 | |
| 338 | −ZZM Custom 11 0 | |
| 339 | −ZZE Europe 13 19 | |
| 340 | −ZZJ Custom Japan 14 4 | |
| 341 | −ZZR Rest of World 14 0 | |
| 342 | −ZZH High Band 13 4 | |
| 343 | −ZZG Custom Europe 13 4 | |
| 344 | −ZZK Europe 13 24 | |
| 345 | −ZZL Europe 11 13 | |
| 346 | − | |
| 347 | − | |
| 348 | −2. Ad-Hoc Networking | |
| 349 | −----------------------------------------------- | |
| 350 | − | |
| 351 | −When using a device in an Ad-Hoc network, it is useful to understand the | |
| 352 | −sequence and requirements for the driver to be able to create, join, or | |
| 366 | + +------+----------------------------+--------------------+ | |
| 367 | + | | | Supported channels | | |
| 368 | + | Code | Geography +----------+---------+ | |
| 369 | + | | | 802.11bg | 802.11a | | |
| 370 | + +======+============================+==========+=========+ | |
| 371 | + | --- | Restricted | 11 | 0 | | |
| 372 | + +------+----------------------------+----------+---------+ | |
| 373 | + | ZZF | Custom US/Canada | 11 | 8 | | |
| 374 | + +------+----------------------------+----------+---------+ | |
| 375 | + | ZZD | Rest of World | 13 | 0 | | |
| 376 | + +------+----------------------------+----------+---------+ | |
| 377 | + | ZZA | Custom USA & Europe & High | 11 | 13 | | |
| 378 | + +------+----------------------------+----------+---------+ | |
| 379 | + | ZZB | Custom NA & Europe | 11 | 13 | | |
| 380 | + +------+----------------------------+----------+---------+ | |
| 381 | + | ZZC | Custom Japan | 11 | 4 | | |
| 382 | + +------+----------------------------+----------+---------+ | |
| 383 | + | ZZM | Custom | 11 | 0 | | |
| 384 | + +------+----------------------------+----------+---------+ | |
| 385 | + | ZZE | Europe | 13 | 19 | | |
| 386 | + +------+----------------------------+----------+---------+ | |
| 387 | + | ZZJ | Custom Japan | 14 | 4 | | |
| 388 | + +------+----------------------------+----------+---------+ | |
| 389 | + | ZZR | Rest of World | 14 | 0 | | |
| 390 | + +------+----------------------------+----------+---------+ | |
| 391 | + | ZZH | High Band | 13 | 4 | | |
| 392 | + +------+----------------------------+----------+---------+ | |
| 393 | + | ZZG | Custom Europe | 13 | 4 | | |
| 394 | + +------+----------------------------+----------+---------+ | |
| 395 | + | ZZK | Europe | 13 | 24 | | |
| 396 | + +------+----------------------------+----------+---------+ | |
| 397 | + | ZZL | Europe | 11 | 13 | | |
| 398 | + +------+----------------------------+----------+---------+ | |
| 399 | + | |
| 400 | +2. Ad-Hoc Networking | |
| 401 | +===================== | |
| 402 | + | |
| 403 | +When using a device in an Ad-Hoc network, it is useful to understand the | |
| 404 | +sequence and requirements for the driver to be able to create, join, or | |
| 353 | 405 | merge networks. |
| 354 | 406 | |
| 355 | −The following attempts to provide enough information so that you can | |
| 356 | −have a consistent experience while using the driver as a member of an | |
| 407 | +The following attempts to provide enough information so that you can | |
| 408 | +have a consistent experience while using the driver as a member of an | |
| 357 | 409 | Ad-Hoc network. |
| 358 | 410 | |
| 359 | 411 | 2.1. Joining an Ad-Hoc Network |
| 360 | −----------------------------------------------- | |
| 412 | +------------------------------ | |
| 361 | 413 | |
| 362 | −The easiest way to get onto an Ad-Hoc network is to join one that | |
| 414 | +The easiest way to get onto an Ad-Hoc network is to join one that | |
| 363 | 415 | already exists. |
| 364 | 416 | |
| 365 | 417 | 2.2. Creating an Ad-Hoc Network |
| 366 | −----------------------------------------------- | |
| 418 | +------------------------------- | |
| 367 | 419 | |
| 368 | 420 | An Ad-Hoc networks is created using the syntax of the Wireless tool. |
| 369 | 421 | |
| @@ -371,21 +423,21 @@ For Example: · 1 unmodified line | ||
| 371 | 423 | iwconfig eth1 mode ad-hoc essid testing channel 2 |
| 372 | 424 | |
| 373 | 425 | 2.3. Merging Ad-Hoc Networks |
| 374 | −----------------------------------------------- | |
| 426 | +---------------------------- | |
| 375 | 427 | |
| 376 | 428 | |
| 377 | −3. Interaction with Wireless Tools | |
| 378 | −----------------------------------------------- | |
| 429 | +3. Interaction with Wireless Tools | |
| 430 | +================================== | |
| 379 | 431 | |
| 380 | 432 | 3.1 iwconfig mode |
| 381 | −----------------------------------------------- | |
| 433 | +----------------- | |
| 382 | 434 | |
| 383 | 435 | When configuring the mode of the adapter, all run-time configured parameters |
| 384 | 436 | are reset to the value used when the module was loaded. This includes |
| 385 | 437 | channels, rates, ESSID, etc. |
| 386 | 438 | |
| 387 | 439 | 3.2 iwconfig sens |
| 388 | −----------------------------------------------- | |
| 440 | +----------------- | |
| 389 | 441 | |
| 390 | 442 | The 'iwconfig ethX sens XX' command will not set the signal sensitivity |
| 391 | 443 | threshold, as described in iwconfig documentation, but rather the number |
| @@ -394,35 +446,35 @@ to another access point. At the same time, it will set the disassociation · 2 unmodified lines | ||
| 394 | 446 | threshold to 3 times the given value. |
| 395 | 447 | |
| 396 | 448 | |
| 397 | −4. About the Version Numbers | |
| 398 | −----------------------------------------------- | |
| 449 | +4. About the Version Numbers | |
| 450 | +============================= | |
| 399 | 451 | |
| 400 | −Due to the nature of open source development projects, there are | |
| 401 | −frequently changes being incorporated that have not gone through | |
| 402 | −a complete validation process. These changes are incorporated into | |
| 452 | +Due to the nature of open source development projects, there are | |
| 453 | +frequently changes being incorporated that have not gone through | |
| 454 | +a complete validation process. These changes are incorporated into | |
| 403 | 455 | development snapshot releases. |
| 404 | 456 | |
| 405 | −Releases are numbered with a three level scheme: | |
| 457 | +Releases are numbered with a three level scheme: | |
| 406 | 458 | |
| 407 | 459 | major.minor.development |
| 408 | 460 | |
| 409 | 461 | Any version where the 'development' portion is 0 (for example |
| 410 | −1.0.0, 1.1.0, etc.) indicates a stable version that will be made | |
| 462 | +1.0.0, 1.1.0, etc.) indicates a stable version that will be made | |
| 411 | 463 | available for kernel inclusion. |
| 412 | 464 | |
| 413 | 465 | Any version where the 'development' portion is not a 0 (for |
| 414 | 466 | example 1.0.1, 1.1.5, etc.) indicates a development version that is |
| 415 | −being made available for testing and cutting edge users. The stability | |
| 467 | +being made available for testing and cutting edge users. The stability | |
| 416 | 468 | and functionality of the development releases are not know. We make |
| 417 | 469 | efforts to try and keep all snapshots reasonably stable, but due to the |
| 418 | −frequency of their release, and the desire to get those releases | |
| 470 | +frequency of their release, and the desire to get those releases | |
| 419 | 471 | available as quickly as possible, unknown anomalies should be expected. |
| 420 | 472 | |
| 421 | 473 | The major version number will be incremented when significant changes |
| 422 | 474 | are made to the driver. Currently, there are no major changes planned. |
| 423 | 475 | |
| 424 | −5. Firmware installation | |
| 425 | −---------------------------------------------- | |
| 476 | +5. Firmware installation | |
| 477 | +======================== | |
| 426 | 478 | |
| 427 | 479 | The driver requires a firmware image, download it and extract the |
| 428 | 480 | files under /lib/firmware (or wherever your hotplug's firmware.agent |
| @@ -433,40 +485,42 @@ The firmware can be downloaded from the following URL: · 4 unmodified lines | ||
| 433 | 485 | http://ipw2200.sf.net/ |
| 434 | 486 | |
| 435 | 487 | |
| 436 | −6. Support | |
| 437 | −----------------------------------------------- | |
| 488 | +6. Support | |
| 489 | +========== | |
| 438 | 490 | |
| 439 | −For direct support of the 1.0.0 version, you can contact | |
| 491 | +For direct support of the 1.0.0 version, you can contact | |
| 440 | 492 | http://supportmail.intel.com, or you can use the open source project |
| 441 | 493 | support. |
| 442 | 494 | |
| 443 | 495 | For general information and support, go to: |
| 444 | − | |
| 496 | + | |
| 445 | 497 | http://ipw2200.sf.net/ |
| 446 | 498 | |
| 447 | 499 | |
| 448 | −7. License | |
| 449 | −----------------------------------------------- | |
| 500 | +7. License | |
| 501 | +========== | |
| 450 | 502 | |
| 451 | − Copyright(c) 2003 - 2006 Intel Corporation. All rights reserved. | |
| 503 | + Copyright |copy| 2003 - 2006 Intel Corporation. All rights reserved. | |
| 452 | 504 | |
| 453 | − This program is free software; you can redistribute it and/or modify it | |
| 454 | − under the terms of the GNU General Public License version 2 as | |
| 505 | + This program is free software; you can redistribute it and/or modify it | |
| 506 | + under the terms of the GNU General Public License version 2 as | |
| 455 | 507 | published by the Free Software Foundation. |
| 456 | − | |
| 457 | − This program is distributed in the hope that it will be useful, but WITHOUT | |
| 458 | − ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 459 | − FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for | |
| 508 | + | |
| 509 | + This program is distributed in the hope that it will be useful, but WITHOUT | |
| 510 | + ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 511 | + FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for | |
| 460 | 512 | more details. |
| 461 | − | |
| 513 | + | |
| 462 | 514 | You should have received a copy of the GNU General Public License along with |
| 463 | − this program; if not, write to the Free Software Foundation, Inc., 59 | |
| 515 | + this program; if not, write to the Free Software Foundation, Inc., 59 | |
| 464 | 516 | Temple Place - Suite 330, Boston, MA 02111-1307, USA. |
| 465 | − | |
| 517 | + | |
| 466 | 518 | The full GNU General Public License is included in this distribution in the |
| 467 | 519 | file called LICENSE. |
| 468 | − | |
| 520 | + | |
| 469 | 521 | Contact Information: |
| 522 | + | |
| 470 | 523 | James P. Ketrenos <ipw2100-admin@linux.intel.com> |
| 524 | + | |
| 471 | 525 | Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497 |
| 472 | 526 | |
| @@ -37,7 +37,7 @@ The following features are available in this kernel: · 36 unmodified lines | ||
| 37 | 37 | - SNMP |
| 38 | 38 | |
| 39 | 39 | Channel Bonding documentation can be found in the Linux kernel source: |
| 40 | −/Documentation/networking/bonding.txt | |
| 40 | +/Documentation/networking/bonding.rst | |
| 41 | 41 | |
| 42 | 42 | The driver information previously displayed in the /proc filesystem is not |
| 43 | 43 | supported in this release. Alternatively, you can use ethtool (version 1.6 |
| @@ -1,3 +1,6 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +====================== | |
| 1 | 4 | Hyper-V network driver |
| 2 | 5 | ====================== |
| 3 | 6 | |
| @@ -10,15 +13,15 @@ Windows 10. · 6 unmodified lines | ||
| 10 | 13 | Features |
| 11 | 14 | ======== |
| 12 | 15 | |
| 13 | − Checksum offload | |
| 14 | − ---------------- | |
| 16 | +Checksum offload | |
| 17 | +---------------- | |
| 15 | 18 | The netvsc driver supports checksum offload as long as the |
| 16 | 19 | Hyper-V host version does. Windows Server 2016 and Azure |
| 17 | 20 | support checksum offload for TCP and UDP for both IPv4 and |
| 18 | 21 | IPv6. Windows Server 2012 only supports checksum offload for TCP. |
| 19 | 22 | |
| 20 | − Receive Side Scaling | |
| 21 | − -------------------- | |
| 23 | +Receive Side Scaling | |
| 24 | +-------------------- | |
| 22 | 25 | Hyper-V supports receive side scaling. For TCP & UDP, packets can |
| 23 | 26 | be distributed among available queues based on IP address and port |
| 24 | 27 | number. |
| @@ -32,30 +35,37 @@ Features · 7 unmodified lines | ||
| 32 | 35 | hashing. Using L3 hashing is recommended in this case. |
| 33 | 36 | |
| 34 | 37 | For example, for UDP over IPv4 on eth0: |
| 35 | − To include UDP port numbers in hashing: | |
| 36 | − ethtool -N eth0 rx-flow-hash udp4 sdfn | |
| 37 | − To exclude UDP port numbers in hashing: | |
| 38 | − ethtool -N eth0 rx-flow-hash udp4 sd | |
| 39 | − To show UDP hash level: | |
| 40 | − ethtool -n eth0 rx-flow-hash udp4 | |
| 41 | − | |
| 42 | − Generic Receive Offload, aka GRO | |
| 43 | − -------------------------------- | |
| 38 | + | |
| 39 | + To include UDP port numbers in hashing:: | |
| 40 | + | |
| 41 | + ethtool -N eth0 rx-flow-hash udp4 sdfn | |
| 42 | + | |
| 43 | + To exclude UDP port numbers in hashing:: | |
| 44 | + | |
| 45 | + ethtool -N eth0 rx-flow-hash udp4 sd | |
| 46 | + | |
| 47 | + To show UDP hash level:: | |
| 48 | + | |
| 49 | + ethtool -n eth0 rx-flow-hash udp4 | |
| 50 | + | |
| 51 | +Generic Receive Offload, aka GRO | |
| 52 | +-------------------------------- | |
| 44 | 53 | The driver supports GRO and it is enabled by default. GRO coalesces |
| 45 | 54 | like packets and significantly reduces CPU usage under heavy Rx |
| 46 | 55 | load. |
| 47 | 56 | |
| 48 | − Large Receive Offload (LRO), or Receive Side Coalescing (RSC) | |
| 49 | − ------------------------------------------------------------- | |
| 57 | +Large Receive Offload (LRO), or Receive Side Coalescing (RSC) | |
| 58 | +------------------------------------------------------------- | |
| 50 | 59 | The driver supports LRO/RSC in the vSwitch feature. It reduces the per packet |
| 51 | 60 | processing overhead by coalescing multiple TCP segments when possible. The |
| 52 | 61 | feature is enabled by default on VMs running on Windows Server 2019 and |
| 53 | − later. It may be changed by ethtool command: | |
| 62 | + later. It may be changed by ethtool command:: | |
| 63 | + | |
| 54 | 64 | ethtool -K eth0 lro on |
| 55 | 65 | ethtool -K eth0 lro off |
| 56 | 66 | |
| 57 | − SR-IOV support | |
| 58 | − -------------- | |
| 67 | +SR-IOV support | |
| 68 | +-------------- | |
| 59 | 69 | Hyper-V supports SR-IOV as a hardware acceleration option. If SR-IOV |
| 60 | 70 | is enabled in both the vSwitch and the guest configuration, then the |
| 61 | 71 | Virtual Function (VF) device is passed to the guest as a PCI |
| @@ -70,8 +80,8 @@ Features · 8 unmodified lines | ||
| 70 | 80 | flow direction is desired, these should be applied directly to the |
| 71 | 81 | VF slave device. |
| 72 | 82 | |
| 73 | − Receive Buffer | |
| 74 | − -------------- | |
| 83 | +Receive Buffer | |
| 84 | +-------------- | |
| 75 | 85 | Packets are received into a receive area which is created when device |
| 76 | 86 | is probed. The receive area is broken into MTU sized chunks and each may |
| 77 | 87 | contain one or more packets. The number of receive sections may be changed |
| @@ -83,8 +93,8 @@ Features · 5 unmodified lines | ||
| 83 | 93 | will use slower method to handle very large packets or if the send buffer |
| 84 | 94 | area is exhausted. |
| 85 | 95 | |
| 86 | − XDP support | |
| 87 | − ----------- | |
| 96 | +XDP support | |
| 97 | +----------- | |
| 88 | 98 | XDP (eXpress Data Path) is a feature that runs eBPF bytecode at the early |
| 89 | 99 | stage when packets arrive at a NIC card. The goal is to increase performance |
| 90 | 100 | for packet processing, reducing the overhead of SKB allocation and other |
| @@ -99,7 +109,8 @@ Features · 8 unmodified lines | ||
| 99 | 109 | overwritten by setting of synthetic NIC. |
| 100 | 110 | |
| 101 | 111 | XDP program cannot run with LRO (RSC) enabled, so you need to disable LRO |
| 102 | − before running XDP: | |
| 112 | + before running XDP:: | |
| 113 | + | |
| 103 | 114 | ethtool -K eth0 lro off |
| 104 | 115 | |
| 105 | 116 | XDP_REDIRECT action is not yet supported. |
| @@ -0,0 +1,196 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +========================================================= | |
| 4 | +Neterion's (Formerly S2io) Xframe I/II PCI-X 10GbE driver | |
| 5 | +========================================================= | |
| 6 | + | |
| 7 | +Release notes for Neterion's (Formerly S2io) Xframe I/II PCI-X 10GbE driver. | |
| 8 | + | |
| 9 | +.. Contents | |
| 10 | + - 1. Introduction | |
| 11 | + - 2. Identifying the adapter/interface | |
| 12 | + - 3. Features supported | |
| 13 | + - 4. Command line parameters | |
| 14 | + - 5. Performance suggestions | |
| 15 | + - 6. Available Downloads | |
| 16 | + | |
| 17 | + | |
| 18 | +1. Introduction | |
| 19 | +=============== | |
| 20 | +This Linux driver supports Neterion's Xframe I PCI-X 1.0 and | |
| 21 | +Xframe II PCI-X 2.0 adapters. It supports several features | |
| 22 | +such as jumbo frames, MSI/MSI-X, checksum offloads, TSO, UFO and so on. | |
| 23 | +See below for complete list of features. | |
| 24 | + | |
| 25 | +All features are supported for both IPv4 and IPv6. | |
| 26 | + | |
| 27 | +2. Identifying the adapter/interface | |
| 28 | +==================================== | |
| 29 | + | |
| 30 | +a. Insert the adapter(s) in your system. | |
| 31 | +b. Build and load driver:: | |
| 32 | + | |
| 33 | + # insmod s2io.ko | |
| 34 | + | |
| 35 | +c. View log messages:: | |
| 36 | + | |
| 37 | + # dmesg | tail -40 | |
| 38 | + | |
| 39 | +You will see messages similar to:: | |
| 40 | + | |
| 41 | + eth3: Neterion Xframe I 10GbE adapter (rev 3), Version 2.0.9.1, Intr type INTA | |
| 42 | + eth4: Neterion Xframe II 10GbE adapter (rev 2), Version 2.0.9.1, Intr type INTA | |
| 43 | + eth4: Device is on 64 bit 133MHz PCIX(M1) bus | |
| 44 | + | |
| 45 | +The above messages identify the adapter type(Xframe I/II), adapter revision, | |
| 46 | +driver version, interface name(eth3, eth4), Interrupt type(INTA, MSI, MSI-X). | |
| 47 | +In case of Xframe II, the PCI/PCI-X bus width and frequency are displayed | |
| 48 | +as well. | |
| 49 | + | |
| 50 | +To associate an interface with a physical adapter use "ethtool -p <ethX>". | |
| 51 | +The corresponding adapter's LED will blink multiple times. | |
| 52 | + | |
| 53 | +3. Features supported | |
| 54 | +===================== | |
| 55 | +a. Jumbo frames. Xframe I/II supports MTU up to 9600 bytes, | |
| 56 | + modifiable using ip command. | |
| 57 | + | |
| 58 | +b. Offloads. Supports checksum offload(TCP/UDP/IP) on transmit | |
| 59 | + and receive, TSO. | |
| 60 | + | |
| 61 | +c. Multi-buffer receive mode. Scattering of packet across multiple | |
| 62 | + buffers. Currently driver supports 2-buffer mode which yields | |
| 63 | + significant performance improvement on certain platforms(SGI Altix, | |
| 64 | + IBM xSeries). | |
| 65 | + | |
| 66 | +d. MSI/MSI-X. Can be enabled on platforms which support this feature | |
| 67 | + (IA64, Xeon) resulting in noticeable performance improvement(up to 7% | |
| 68 | + on certain platforms). | |
| 69 | + | |
| 70 | +e. Statistics. Comprehensive MAC-level and software statistics displayed | |
| 71 | + using "ethtool -S" option. | |
| 72 | + | |
| 73 | +f. Multi-FIFO/Ring. Supports up to 8 transmit queues and receive rings, | |
| 74 | + with multiple steering options. | |
| 75 | + | |
| 76 | +4. Command line parameters | |
| 77 | +========================== | |
| 78 | + | |
| 79 | +a. tx_fifo_num | |
| 80 | + Number of transmit queues | |
| 81 | + | |
| 82 | +Valid range: 1-8 | |
| 83 | + | |
| 84 | +Default: 1 | |
| 85 | + | |
| 86 | +b. rx_ring_num | |
| 87 | + Number of receive rings | |
| 88 | + | |
| 89 | +Valid range: 1-8 | |
| 90 | + | |
| 91 | +Default: 1 | |
| 92 | + | |
| 93 | +c. tx_fifo_len | |
| 94 | + Size of each transmit queue | |
| 95 | + | |
| 96 | +Valid range: Total length of all queues should not exceed 8192 | |
| 97 | + | |
| 98 | +Default: 4096 | |
| 99 | + | |
| 100 | +d. rx_ring_sz | |
| 101 | + Size of each receive ring(in 4K blocks) | |
| 102 | + | |
| 103 | +Valid range: Limited by memory on system | |
| 104 | + | |
| 105 | +Default: 30 | |
| 106 | + | |
| 107 | +e. intr_type | |
| 108 | + Specifies interrupt type. Possible values 0(INTA), 2(MSI-X) | |
| 109 | + | |
| 110 | +Valid values: 0, 2 | |
| 111 | + | |
| 112 | +Default: 2 | |
| 113 | + | |
| 114 | +5. Performance suggestions | |
| 115 | +========================== | |
| 116 | + | |
| 117 | +General: | |
| 118 | + | |
| 119 | +a. Set MTU to maximum(9000 for switch setup, 9600 in back-to-back configuration) | |
| 120 | +b. Set TCP windows size to optimal value. | |
| 121 | + | |
| 122 | +For instance, for MTU=1500 a value of 210K has been observed to result in | |
| 123 | +good performance:: | |
| 124 | + | |
| 125 | + # sysctl -w net.ipv4.tcp_rmem="210000 210000 210000" | |
| 126 | + # sysctl -w net.ipv4.tcp_wmem="210000 210000 210000" | |
| 127 | + | |
| 128 | +For MTU=9000, TCP window size of 10 MB is recommended:: | |
| 129 | + | |
| 130 | + # sysctl -w net.ipv4.tcp_rmem="10000000 10000000 10000000" | |
| 131 | + # sysctl -w net.ipv4.tcp_wmem="10000000 10000000 10000000" | |
| 132 | + | |
| 133 | +Transmit performance: | |
| 134 | + | |
| 135 | +a. By default, the driver respects BIOS settings for PCI bus parameters. | |
| 136 | + However, you may want to experiment with PCI bus parameters | |
| 137 | + max-split-transactions(MOST) and MMRBC (use setpci command). | |
| 138 | + | |
| 139 | + A MOST value of 2 has been found optimal for Opterons and 3 for Itanium. | |
| 140 | + | |
| 141 | + It could be different for your hardware. | |
| 142 | + | |
| 143 | + Set MMRBC to 4K**. | |
| 144 | + | |
| 145 | + For example you can set | |
| 146 | + | |
| 147 | + For opteron:: | |
| 148 | + | |
| 149 | + #setpci -d 17d5:* 62=1d | |
| 150 | + | |
| 151 | + For Itanium:: | |
| 152 | + | |
| 153 | + #setpci -d 17d5:* 62=3d | |
| 154 | + | |
| 155 | + For detailed description of the PCI registers, please see Xframe User Guide. | |
| 156 | + | |
| 157 | +b. Ensure Transmit Checksum offload is enabled. Use ethtool to set/verify this | |
| 158 | + parameter. | |
| 159 | + | |
| 160 | +c. Turn on TSO(using "ethtool -K"):: | |
| 161 | + | |
| 162 | + # ethtool -K <ethX> tso on | |
| 163 | + | |
| 164 | +Receive performance: | |
| 165 | + | |
| 166 | +a. By default, the driver respects BIOS settings for PCI bus parameters. | |
| 167 | + However, you may want to set PCI latency timer to 248:: | |
| 168 | + | |
| 169 | + #setpci -d 17d5:* LATENCY_TIMER=f8 | |
| 170 | + | |
| 171 | + For detailed description of the PCI registers, please see Xframe User Guide. | |
| 172 | + | |
| 173 | +b. Use 2-buffer mode. This results in large performance boost on | |
| 174 | + certain platforms(eg. SGI Altix, IBM xSeries). | |
| 175 | + | |
| 176 | +c. Ensure Receive Checksum offload is enabled. Use "ethtool -K ethX" command to | |
| 177 | + set/verify this option. | |
| 178 | + | |
| 179 | +d. Enable NAPI feature(in kernel configuration Device Drivers ---> Network | |
| 180 | + device support ---> Ethernet (10000 Mbit) ---> S2IO 10Gbe Xframe NIC) to | |
| 181 | + bring down CPU utilization. | |
| 182 | + | |
| 183 | +.. note:: | |
| 184 | + | |
| 185 | + For AMD opteron platforms with 8131 chipset, MMRBC=1 and MOST=1 are | |
| 186 | + recommended as safe parameters. | |
| 187 | + | |
| 188 | +For more information, please review the AMD8131 errata at | |
| 189 | +http://vip.amd.com/us-en/assets/content_type/white_papers_and_tech_docs/ | |
| 190 | +26310_AMD-8131_HyperTransport_PCI-X_Tunnel_Revision_Guide_rev_3_18.pdf | |
| 191 | + | |
| 192 | +6. Support | |
| 193 | +========== | |
| 194 | + | |
| 195 | +For further support please contact either your 10GbE Xframe NIC vendor (IBM, | |
| 196 | +HP, SGI etc.) | |
| @@ -1,141 +0,0 @@ | ||
| 1 | −Release notes for Neterion's (Formerly S2io) Xframe I/II PCI-X 10GbE driver. | |
| 2 | − | |
| 3 | −Contents | |
| 4 | −======= | |
| 5 | −- 1. Introduction | |
| 6 | −- 2. Identifying the adapter/interface | |
| 7 | −- 3. Features supported | |
| 8 | −- 4. Command line parameters | |
| 9 | −- 5. Performance suggestions | |
| 10 | −- 6. Available Downloads | |
| 11 | − | |
| 12 | − | |
| 13 | −1. Introduction: | |
| 14 | −This Linux driver supports Neterion's Xframe I PCI-X 1.0 and | |
| 15 | −Xframe II PCI-X 2.0 adapters. It supports several features | |
| 16 | −such as jumbo frames, MSI/MSI-X, checksum offloads, TSO, UFO and so on. | |
| 17 | −See below for complete list of features. | |
| 18 | −All features are supported for both IPv4 and IPv6. | |
| 19 | − | |
| 20 | −2. Identifying the adapter/interface: | |
| 21 | −a. Insert the adapter(s) in your system. | |
| 22 | −b. Build and load driver | |
| 23 | −# insmod s2io.ko | |
| 24 | −c. View log messages | |
| 25 | −# dmesg | tail -40 | |
| 26 | −You will see messages similar to: | |
| 27 | −eth3: Neterion Xframe I 10GbE adapter (rev 3), Version 2.0.9.1, Intr type INTA | |
| 28 | −eth4: Neterion Xframe II 10GbE adapter (rev 2), Version 2.0.9.1, Intr type INTA | |
| 29 | −eth4: Device is on 64 bit 133MHz PCIX(M1) bus | |
| 30 | − | |
| 31 | −The above messages identify the adapter type(Xframe I/II), adapter revision, | |
| 32 | −driver version, interface name(eth3, eth4), Interrupt type(INTA, MSI, MSI-X). | |
| 33 | −In case of Xframe II, the PCI/PCI-X bus width and frequency are displayed | |
| 34 | −as well. | |
| 35 | − | |
| 36 | −To associate an interface with a physical adapter use "ethtool -p <ethX>". | |
| 37 | −The corresponding adapter's LED will blink multiple times. | |
| 38 | − | |
| 39 | −3. Features supported: | |
| 40 | −a. Jumbo frames. Xframe I/II supports MTU up to 9600 bytes, | |
| 41 | −modifiable using ip command. | |
| 42 | − | |
| 43 | −b. Offloads. Supports checksum offload(TCP/UDP/IP) on transmit | |
| 44 | −and receive, TSO. | |
| 45 | − | |
| 46 | −c. Multi-buffer receive mode. Scattering of packet across multiple | |
| 47 | −buffers. Currently driver supports 2-buffer mode which yields | |
| 48 | −significant performance improvement on certain platforms(SGI Altix, | |
| 49 | −IBM xSeries). | |
| 50 | − | |
| 51 | −d. MSI/MSI-X. Can be enabled on platforms which support this feature | |
| 52 | −(IA64, Xeon) resulting in noticeable performance improvement(up to 7% | |
| 53 | −on certain platforms). | |
| 54 | − | |
| 55 | −e. Statistics. Comprehensive MAC-level and software statistics displayed | |
| 56 | −using "ethtool -S" option. | |
| 57 | − | |
| 58 | −f. Multi-FIFO/Ring. Supports up to 8 transmit queues and receive rings, | |
| 59 | −with multiple steering options. | |
| 60 | − | |
| 61 | −4. Command line parameters | |
| 62 | −a. tx_fifo_num | |
| 63 | −Number of transmit queues | |
| 64 | −Valid range: 1-8 | |
| 65 | −Default: 1 | |
| 66 | − | |
| 67 | −b. rx_ring_num | |
| 68 | −Number of receive rings | |
| 69 | −Valid range: 1-8 | |
| 70 | −Default: 1 | |
| 71 | − | |
| 72 | −c. tx_fifo_len | |
| 73 | −Size of each transmit queue | |
| 74 | −Valid range: Total length of all queues should not exceed 8192 | |
| 75 | −Default: 4096 | |
| 76 | − | |
| 77 | −d. rx_ring_sz | |
| 78 | −Size of each receive ring(in 4K blocks) | |
| 79 | −Valid range: Limited by memory on system | |
| 80 | −Default: 30 | |
| 81 | − | |
| 82 | −e. intr_type | |
| 83 | −Specifies interrupt type. Possible values 0(INTA), 2(MSI-X) | |
| 84 | −Valid values: 0, 2 | |
| 85 | −Default: 2 | |
| 86 | − | |
| 87 | −5. Performance suggestions | |
| 88 | −General: | |
| 89 | −a. Set MTU to maximum(9000 for switch setup, 9600 in back-to-back configuration) | |
| 90 | −b. Set TCP windows size to optimal value. | |
| 91 | −For instance, for MTU=1500 a value of 210K has been observed to result in | |
| 92 | −good performance. | |
| 93 | −# sysctl -w net.ipv4.tcp_rmem="210000 210000 210000" | |
| 94 | −# sysctl -w net.ipv4.tcp_wmem="210000 210000 210000" | |
| 95 | −For MTU=9000, TCP window size of 10 MB is recommended. | |
| 96 | −# sysctl -w net.ipv4.tcp_rmem="10000000 10000000 10000000" | |
| 97 | −# sysctl -w net.ipv4.tcp_wmem="10000000 10000000 10000000" | |
| 98 | − | |
| 99 | −Transmit performance: | |
| 100 | −a. By default, the driver respects BIOS settings for PCI bus parameters. | |
| 101 | −However, you may want to experiment with PCI bus parameters | |
| 102 | −max-split-transactions(MOST) and MMRBC (use setpci command). | |
| 103 | −A MOST value of 2 has been found optimal for Opterons and 3 for Itanium. | |
| 104 | −It could be different for your hardware. | |
| 105 | −Set MMRBC to 4K**. | |
| 106 | − | |
| 107 | −For example you can set | |
| 108 | −For opteron | |
| 109 | −#setpci -d 17d5:* 62=1d | |
| 110 | −For Itanium | |
| 111 | −#setpci -d 17d5:* 62=3d | |
| 112 | − | |
| 113 | −For detailed description of the PCI registers, please see Xframe User Guide. | |
| 114 | − | |
| 115 | −b. Ensure Transmit Checksum offload is enabled. Use ethtool to set/verify this | |
| 116 | −parameter. | |
| 117 | −c. Turn on TSO(using "ethtool -K") | |
| 118 | −# ethtool -K <ethX> tso on | |
| 119 | − | |
| 120 | −Receive performance: | |
| 121 | −a. By default, the driver respects BIOS settings for PCI bus parameters. | |
| 122 | −However, you may want to set PCI latency timer to 248. | |
| 123 | −#setpci -d 17d5:* LATENCY_TIMER=f8 | |
| 124 | −For detailed description of the PCI registers, please see Xframe User Guide. | |
| 125 | −b. Use 2-buffer mode. This results in large performance boost on | |
| 126 | −certain platforms(eg. SGI Altix, IBM xSeries). | |
| 127 | −c. Ensure Receive Checksum offload is enabled. Use "ethtool -K ethX" command to | |
| 128 | −set/verify this option. | |
| 129 | −d. Enable NAPI feature(in kernel configuration Device Drivers ---> Network | |
| 130 | −device support ---> Ethernet (10000 Mbit) ---> S2IO 10Gbe Xframe NIC) to | |
| 131 | −bring down CPU utilization. | |
| 132 | − | |
| 133 | −** For AMD opteron platforms with 8131 chipset, MMRBC=1 and MOST=1 are | |
| 134 | −recommended as safe parameters. | |
| 135 | −For more information, please review the AMD8131 errata at | |
| 136 | −http://vip.amd.com/us-en/assets/content_type/white_papers_and_tech_docs/ | |
| 137 | −26310_AMD-8131_HyperTransport_PCI-X_Tunnel_Revision_Guide_rev_3_18.pdf | |
| 138 | − | |
| 139 | −6. Support | |
| 140 | −For further support please contact either your 10GbE Xframe NIC vendor (IBM, | |
| 141 | −HP, SGI etc.) | |
| @@ -1,24 +1,30 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +============================================================================== | |
| 1 | 4 | Neterion's (Formerly S2io) X3100 Series 10GbE PCIe Server Adapter Linux driver |
| 2 | 5 | ============================================================================== |
| 3 | 6 | |
| 4 | −Contents | |
| 5 | −-------- | |
| 7 | +.. Contents | |
| 8 | + | |
| 9 | + 1) Introduction | |
| 10 | + 2) Features supported | |
| 11 | + 3) Configurable driver parameters | |
| 12 | + 4) Troubleshooting | |
| 6 | 13 | |
| 7 | −1) Introduction | |
| 8 | −2) Features supported | |
| 9 | −3) Configurable driver parameters | |
| 10 | −4) Troubleshooting | |
| 14 | +1. Introduction | |
| 15 | +=============== | |
| 11 | 16 | |
| 12 | −1) Introduction: | |
| 13 | −---------------- | |
| 14 | 17 | This Linux driver supports all Neterion's X3100 series 10 GbE PCIe I/O |
| 15 | 18 | Virtualized Server adapters. |
| 19 | + | |
| 16 | 20 | The X3100 series supports four modes of operation, configurable via |
| 17 | −firmware - | |
| 18 | − Single function mode | |
| 19 | − Multi function mode | |
| 20 | − SRIOV mode | |
| 21 | − MRIOV mode | |
| 21 | +firmware: | |
| 22 | + | |
| 23 | + - Single function mode | |
| 24 | + - Multi function mode | |
| 25 | + - SRIOV mode | |
| 26 | + - MRIOV mode | |
| 27 | + | |
| 22 | 28 | The functions share a 10GbE link and the pci-e bus, but hardly anything else |
| 23 | 29 | inside the ASIC. Features like independent hw reset, statistics, bandwidth/ |
| 24 | 30 | priority allocation and guarantees, GRO, TSO, interrupt moderation etc are |
| @@ -26,41 +32,49 @@ supported independently on each function. · 1 unmodified line | ||
| 26 | 32 | |
| 27 | 33 | (See below for a complete list of features supported for both IPv4 and IPv6) |
| 28 | 34 | |
| 29 | −2) Features supported: | |
| 30 | −---------------------- | |
| 35 | +2. Features supported | |
| 36 | +===================== | |
| 31 | 37 | |
| 32 | 38 | i) Single function mode (up to 17 queues) |
| 33 | 39 | |
| 34 | 40 | ii) Multi function mode (up to 17 functions) |
| 35 | 41 | |
| 36 | 42 | iii) PCI-SIG's I/O Virtualization |
| 43 | + | |
| 37 | 44 | - Single Root mode: v1.0 (up to 17 functions) |
| 38 | 45 | - Multi-Root mode: v1.0 (up to 17 functions) |
| 39 | 46 | |
| 40 | 47 | iv) Jumbo frames |
| 48 | + | |
| 41 | 49 | X3100 Series supports MTU up to 9600 bytes, modifiable using |
| 42 | 50 | ip command. |
| 43 | 51 | |
| 44 | 52 | v) Offloads supported: (Enabled by default) |
| 45 | − Checksum offload (TCP/UDP/IP) on transmit and receive paths | |
| 46 | − TCP Segmentation Offload (TSO) on transmit path | |
| 47 | − Generic Receive Offload (GRO) on receive path | |
| 53 | + | |
| 54 | + - Checksum offload (TCP/UDP/IP) on transmit and receive paths | |
| 55 | + - TCP Segmentation Offload (TSO) on transmit path | |
| 56 | + - Generic Receive Offload (GRO) on receive path | |
| 48 | 57 | |
| 49 | 58 | vi) MSI-X: (Enabled by default) |
| 59 | + | |
| 50 | 60 | Resulting in noticeable performance improvement (up to 7% on certain |
| 51 | 61 | platforms). |
| 52 | 62 | |
| 53 | 63 | vii) NAPI: (Enabled by default) |
| 64 | + | |
| 54 | 65 | For better Rx interrupt moderation. |
| 55 | 66 | |
| 56 | 67 | viii)RTH (Receive Traffic Hash): (Enabled by default) |
| 68 | + | |
| 57 | 69 | Receive side steering for better scaling. |
| 58 | 70 | |
| 59 | 71 | ix) Statistics |
| 72 | + | |
| 60 | 73 | Comprehensive MAC-level and software statistics displayed using |
| 61 | 74 | "ethtool -S" option. |
| 62 | 75 | |
| 63 | 76 | x) Multiple hardware queues: (Enabled by default) |
| 77 | + | |
| 64 | 78 | Up to 17 hardware based transmit and receive data channels, with |
| 65 | 79 | multiple steering options (transmit multiqueue enabled by default). |
| 66 | 80 | |
| @@ -69,25 +83,33 @@ x) Multiple hardware queues: (Enabled by default) · 2 unmodified lines | ||
| 69 | 83 | |
| 70 | 84 | i) max_config_dev |
| 71 | 85 | Specifies maximum device functions to be enabled. |
| 86 | + | |
| 72 | 87 | Valid range: 1-8 |
| 73 | 88 | |
| 74 | 89 | ii) max_config_port |
| 75 | 90 | Specifies number of ports to be enabled. |
| 91 | + | |
| 76 | 92 | Valid range: 1,2 |
| 93 | + | |
| 77 | 94 | Default: 1 |
| 78 | 95 | |
| 79 | −iii)max_config_vpath | |
| 96 | +iii) max_config_vpath | |
| 80 | 97 | Specifies maximum VPATH(s) configured for each device function. |
| 98 | + | |
| 81 | 99 | Valid range: 1-17 |
| 82 | 100 | |
| 83 | 101 | iv) vlan_tag_strip |
| 84 | 102 | Enables/disables vlan tag stripping from all received tagged frames that |
| 85 | 103 | are not replicated at the internal L2 switch. |
| 104 | + | |
| 86 | 105 | Valid range: 0,1 (disabled, enabled respectively) |
| 106 | + | |
| 87 | 107 | Default: 1 |
| 88 | 108 | |
| 89 | 109 | v) addr_learn_en |
| 90 | 110 | Enable learning the mac address of the guest OS interface in |
| 91 | 111 | virtualization environment. |
| 112 | + | |
| 92 | 113 | Valid range: 0,1 (disabled, enabled respectively) |
| 114 | + | |
| 93 | 115 | Default: 0 |
| @@ -11,6 +11,9 @@ Contents · 10 unmodified lines | ||
| 11 | 11 | ======== |
| 12 | 12 | |
| 13 | 13 | - Identifying the Adapter |
| 14 | +- Enabling the driver | |
| 15 | +- Configuring the driver | |
| 16 | +- Statistics | |
| 14 | 17 | - Support |
| 15 | 18 | |
| 16 | 19 | Identifying the Adapter |
| @@ -28,12 +31,238 @@ and configure them for use. There should be log entries in the kernel · 11 unmodified lines | ||
| 28 | 31 | messages such as these:: |
| 29 | 32 | |
| 30 | 33 | $ dmesg | grep ionic |
| 31 | − ionic Pensando Ethernet NIC Driver, ver 0.15.0-k | |
| 34 | + ionic 0000:b5:00.0: 126.016 Gb/s available PCIe bandwidth (8.0 GT/s PCIe x16 link) | |
| 32 | 35 | ionic 0000:b5:00.0 enp181s0: renamed from eth0 |
| 36 | + ionic 0000:b5:00.0 enp181s0: Link up - 100 Gbps | |
| 37 | + ionic 0000:b6:00.0: 126.016 Gb/s available PCIe bandwidth (8.0 GT/s PCIe x16 link) | |
| 33 | 38 | ionic 0000:b6:00.0 enp182s0: renamed from eth0 |
| 39 | + ionic 0000:b6:00.0 enp182s0: Link up - 100 Gbps | |
| 40 | + | |
| 41 | +Driver and firmware version information can be gathered with either of | |
| 42 | +ethtool or devlink tools:: | |
| 43 | + | |
| 44 | + $ ethtool -i enp181s0 | |
| 45 | + driver: ionic | |
| 46 | + version: 5.7.0 | |
| 47 | + firmware-version: 1.8.0-28 | |
| 48 | + ... | |
| 49 | + | |
| 50 | + $ devlink dev info pci/0000:b5:00.0 | |
| 51 | + pci/0000:b5:00.0: | |
| 52 | + driver ionic | |
| 53 | + serial_number FLM18420073 | |
| 54 | + versions: | |
| 55 | + fixed: | |
| 56 | + asic.id 0x0 | |
| 57 | + asic.rev 0x0 | |
| 58 | + running: | |
| 59 | + fw 1.8.0-28 | |
| 60 | + | |
| 61 | +See Documentation/networking/devlink/ionic.rst for more information | |
| 62 | +on the devlink dev info data. | |
| 63 | + | |
| 64 | +Enabling the driver | |
| 65 | +=================== | |
| 66 | + | |
| 67 | +The driver is enabled via the standard kernel configuration system, | |
| 68 | +using the make command:: | |
| 69 | + | |
| 70 | + make oldconfig/menuconfig/etc. | |
| 71 | + | |
| 72 | +The driver is located in the menu structure at: | |
| 73 | + | |
| 74 | + -> Device Drivers | |
| 75 | + -> Network device support (NETDEVICES [=y]) | |
| 76 | + -> Ethernet driver support | |
| 77 | + -> Pensando devices | |
| 78 | + -> Pensando Ethernet IONIC Support | |
| 79 | + | |
| 80 | +Configuring the Driver | |
| 81 | +====================== | |
| 82 | + | |
| 83 | +MTU | |
| 84 | +--- | |
| 85 | + | |
| 86 | +Jumbo frame support is available with a maximim size of 9194 bytes. | |
| 87 | + | |
| 88 | +Interrupt coalescing | |
| 89 | +-------------------- | |
| 90 | + | |
| 91 | +Interrupt coalescing can be configured by changing the rx-usecs value with | |
| 92 | +the "ethtool -C" command. The rx-usecs range is 0-190. The tx-usecs value | |
| 93 | +reflects the rx-usecs value as they are tied together on the same interrupt. | |
| 94 | + | |
| 95 | +SR-IOV | |
| 96 | +------ | |
| 97 | + | |
| 98 | +Minimal SR-IOV support is currently offered and can be enabled by setting | |
| 99 | +the sysfs 'sriov_numvfs' value, if supported by your particular firmware | |
| 100 | +configuration. | |
| 101 | + | |
| 102 | +Statistics | |
| 103 | +========== | |
| 104 | + | |
| 105 | +Basic hardware stats | |
| 106 | +-------------------- | |
| 107 | + | |
| 108 | +The commands ``netstat -i``, ``ip -s link show``, and ``ifconfig`` show | |
| 109 | +a limited set of statistics taken directly from firmware. For example:: | |
| 110 | + | |
| 111 | + $ ip -s link show enp181s0 | |
| 112 | + 7: enp181s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP mode DEFAULT group default qlen 1000 | |
| 113 | + link/ether 00:ae:cd:00:07:68 brd ff:ff:ff:ff:ff:ff | |
| 114 | + RX: bytes packets errors dropped overrun mcast | |
| 115 | + 414 5 0 0 0 0 | |
| 116 | + TX: bytes packets errors dropped carrier collsns | |
| 117 | + 1384 18 0 0 0 0 | |
| 118 | + | |
| 119 | +ethtool -S | |
| 120 | +---------- | |
| 121 | + | |
| 122 | +The statistics shown from the ``ethtool -S`` command includes a combination of | |
| 123 | +driver counters and firmware counters, including port and queue specific values. | |
| 124 | +The driver values are counters computed by the driver, and the firmware values | |
| 125 | +are gathered by the firmware from the port hardware and passed through the | |
| 126 | +driver with no further interpretation. | |
| 127 | + | |
| 128 | +Driver port specific:: | |
| 129 | + | |
| 130 | + tx_packets: 12 | |
| 131 | + tx_bytes: 964 | |
| 132 | + rx_packets: 5 | |
| 133 | + rx_bytes: 414 | |
| 134 | + tx_tso: 0 | |
| 135 | + tx_tso_bytes: 0 | |
| 136 | + tx_csum_none: 12 | |
| 137 | + tx_csum: 0 | |
| 138 | + rx_csum_none: 0 | |
| 139 | + rx_csum_complete: 3 | |
| 140 | + rx_csum_error: 0 | |
| 141 | + | |
| 142 | +Driver queue specific:: | |
| 143 | + | |
| 144 | + tx_0_pkts: 3 | |
| 145 | + tx_0_bytes: 294 | |
| 146 | + tx_0_clean: 3 | |
| 147 | + tx_0_dma_map_err: 0 | |
| 148 | + tx_0_linearize: 0 | |
| 149 | + tx_0_frags: 0 | |
| 150 | + tx_0_tso: 0 | |
| 151 | + tx_0_tso_bytes: 0 | |
| 152 | + tx_0_csum_none: 3 | |
| 153 | + tx_0_csum: 0 | |
| 154 | + tx_0_vlan_inserted: 0 | |
| 155 | + rx_0_pkts: 2 | |
| 156 | + rx_0_bytes: 120 | |
| 157 | + rx_0_dma_map_err: 0 | |
| 158 | + rx_0_alloc_err: 0 | |
| 159 | + rx_0_csum_none: 0 | |
| 160 | + rx_0_csum_complete: 0 | |
| 161 | + rx_0_csum_error: 0 | |
| 162 | + rx_0_dropped: 0 | |
| 163 | + rx_0_vlan_stripped: 0 | |
| 164 | + | |
| 165 | +Firmware port specific:: | |
| 166 | + | |
| 167 | + hw_tx_dropped: 0 | |
| 168 | + hw_rx_dropped: 0 | |
| 169 | + hw_rx_over_errors: 0 | |
| 170 | + hw_rx_missed_errors: 0 | |
| 171 | + hw_tx_aborted_errors: 0 | |
| 172 | + frames_rx_ok: 15 | |
| 173 | + frames_rx_all: 15 | |
| 174 | + frames_rx_bad_fcs: 0 | |
| 175 | + frames_rx_bad_all: 0 | |
| 176 | + octets_rx_ok: 1290 | |
| 177 | + octets_rx_all: 1290 | |
| 178 | + frames_rx_unicast: 10 | |
| 179 | + frames_rx_multicast: 5 | |
| 180 | + frames_rx_broadcast: 0 | |
| 181 | + frames_rx_pause: 0 | |
| 182 | + frames_rx_bad_length: 0 | |
| 183 | + frames_rx_undersized: 0 | |
| 184 | + frames_rx_oversized: 0 | |
| 185 | + frames_rx_fragments: 0 | |
| 186 | + frames_rx_jabber: 0 | |
| 187 | + frames_rx_pripause: 0 | |
| 188 | + frames_rx_stomped_crc: 0 | |
| 189 | + frames_rx_too_long: 0 | |
| 190 | + frames_rx_vlan_good: 3 | |
| 191 | + frames_rx_dropped: 0 | |
| 192 | + frames_rx_less_than_64b: 0 | |
| 193 | + frames_rx_64b: 4 | |
| 194 | + frames_rx_65b_127b: 11 | |
| 195 | + frames_rx_128b_255b: 0 | |
| 196 | + frames_rx_256b_511b: 0 | |
| 197 | + frames_rx_512b_1023b: 0 | |
| 198 | + frames_rx_1024b_1518b: 0 | |
| 199 | + frames_rx_1519b_2047b: 0 | |
| 200 | + frames_rx_2048b_4095b: 0 | |
| 201 | + frames_rx_4096b_8191b: 0 | |
| 202 | + frames_rx_8192b_9215b: 0 | |
| 203 | + frames_rx_other: 0 | |
| 204 | + frames_tx_ok: 31 | |
| 205 | + frames_tx_all: 31 | |
| 206 | + frames_tx_bad: 0 | |
| 207 | + octets_tx_ok: 2614 | |
| 208 | + octets_tx_total: 2614 | |
| 209 | + frames_tx_unicast: 8 | |
| 210 | + frames_tx_multicast: 21 | |
| 211 | + frames_tx_broadcast: 2 | |
| 212 | + frames_tx_pause: 0 | |
| 213 | + frames_tx_pripause: 0 | |
| 214 | + frames_tx_vlan: 0 | |
| 215 | + frames_tx_less_than_64b: 0 | |
| 216 | + frames_tx_64b: 4 | |
| 217 | + frames_tx_65b_127b: 27 | |
| 218 | + frames_tx_128b_255b: 0 | |
| 219 | + frames_tx_256b_511b: 0 | |
| 220 | + frames_tx_512b_1023b: 0 | |
| 221 | + frames_tx_1024b_1518b: 0 | |
| 222 | + frames_tx_1519b_2047b: 0 | |
| 223 | + frames_tx_2048b_4095b: 0 | |
| 224 | + frames_tx_4096b_8191b: 0 | |
| 225 | + frames_tx_8192b_9215b: 0 | |
| 226 | + frames_tx_other: 0 | |
| 227 | + frames_tx_pri_0: 0 | |
| 228 | + frames_tx_pri_1: 0 | |
| 229 | + frames_tx_pri_2: 0 | |
| 230 | + frames_tx_pri_3: 0 | |
| 231 | + frames_tx_pri_4: 0 | |
| 232 | + frames_tx_pri_5: 0 | |
| 233 | + frames_tx_pri_6: 0 | |
| 234 | + frames_tx_pri_7: 0 | |
| 235 | + frames_rx_pri_0: 0 | |
| 236 | + frames_rx_pri_1: 0 | |
| 237 | + frames_rx_pri_2: 0 | |
| 238 | + frames_rx_pri_3: 0 | |
| 239 | + frames_rx_pri_4: 0 | |
| 240 | + frames_rx_pri_5: 0 | |
| 241 | + frames_rx_pri_6: 0 | |
| 242 | + frames_rx_pri_7: 0 | |
| 243 | + tx_pripause_0_1us_count: 0 | |
| 244 | + tx_pripause_1_1us_count: 0 | |
| 245 | + tx_pripause_2_1us_count: 0 | |
| 246 | + tx_pripause_3_1us_count: 0 | |
| 247 | + tx_pripause_4_1us_count: 0 | |
| 248 | + tx_pripause_5_1us_count: 0 | |
| 249 | + tx_pripause_6_1us_count: 0 | |
| 250 | + tx_pripause_7_1us_count: 0 | |
| 251 | + rx_pripause_0_1us_count: 0 | |
| 252 | + rx_pripause_1_1us_count: 0 | |
| 253 | + rx_pripause_2_1us_count: 0 | |
| 254 | + rx_pripause_3_1us_count: 0 | |
| 255 | + rx_pripause_4_1us_count: 0 | |
| 256 | + rx_pripause_5_1us_count: 0 | |
| 257 | + rx_pripause_6_1us_count: 0 | |
| 258 | + rx_pripause_7_1us_count: 0 | |
| 259 | + rx_pause_1us_count: 0 | |
| 260 | + frames_tx_truncated: 0 | |
| 261 | + | |
| 34 | 262 | |
| 35 | 263 | Support |
| 36 | 264 | ======= |
| 265 | + | |
| 37 | 266 | For general Linux networking support, please use the netdev mailing |
| 38 | 267 | list, which is monitored by Pensando personnel:: |
| 39 | 268 | |
| @@ -1,4 +1,11 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +============ | |
| 4 | +Rmnet Driver | |
| 5 | +============ | |
| 6 | + | |
| 1 | 7 | 1. Introduction |
| 8 | +=============== | |
| 2 | 9 | |
| 3 | 10 | rmnet driver is used for supporting the Multiplexing and aggregation |
| 4 | 11 | Protocol (MAP). This protocol is used by all recent chipsets using Qualcomm |
| @@ -18,17 +25,18 @@ sending aggregated bunch of MAP frames. rmnet driver will de-aggregate · 13 unmodified lines | ||
| 18 | 25 | these MAP frames and send them to appropriate PDN's. |
| 19 | 26 | |
| 20 | 27 | 2. Packet format |
| 28 | +================ | |
| 21 | 29 | |
| 22 | 30 | a. MAP packet (data / control) |
| 23 | 31 | |
| 24 | 32 | MAP header has the same endianness of the IP packet. |
| 25 | 33 | |
| 26 | −Packet format - | |
| 34 | +Packet format:: | |
| 27 | 35 | |
| 28 | −Bit 0 1 2-7 8 - 15 16 - 31 | |
| 29 | −Function Command / Data Reserved Pad Multiplexer ID Payload length | |
| 30 | −Bit 32 - x | |
| 31 | −Function Raw Bytes | |
| 36 | + Bit 0 1 2-7 8 - 15 16 - 31 | |
| 37 | + Function Command / Data Reserved Pad Multiplexer ID Payload length | |
| 38 | + Bit 32 - x | |
| 39 | + Function Raw Bytes | |
| 32 | 40 | |
| 33 | 41 | Command (1)/ Data (0) bit value is to indicate if the packet is a MAP command |
| 34 | 42 | or data packet. Control packet is used for transport level flow control. Data |
| @@ -44,24 +52,27 @@ Multiplexer ID is to indicate the PDN on which data has to be sent. · 9 unmodified lines | ||
| 44 | 52 | Payload length includes the padding length but does not include MAP header |
| 45 | 53 | length. |
| 46 | 54 | |
| 47 | −b. MAP packet (command specific) | |
| 55 | +b. MAP packet (command specific):: | |
| 48 | 56 | |
| 49 | −Bit 0 1 2-7 8 - 15 16 - 31 | |
| 50 | −Function Command Reserved Pad Multiplexer ID Payload length | |
| 51 | −Bit 32 - 39 40 - 45 46 - 47 48 - 63 | |
| 52 | −Function Command name Reserved Command Type Reserved | |
| 53 | −Bit 64 - 95 | |
| 54 | −Function Transaction ID | |
| 55 | −Bit 96 - 127 | |
| 56 | −Function Command data | |
| 57 | + Bit 0 1 2-7 8 - 15 16 - 31 | |
| 58 | + Function Command Reserved Pad Multiplexer ID Payload length | |
| 59 | + Bit 32 - 39 40 - 45 46 - 47 48 - 63 | |
| 60 | + Function Command name Reserved Command Type Reserved | |
| 61 | + Bit 64 - 95 | |
| 62 | + Function Transaction ID | |
| 63 | + Bit 96 - 127 | |
| 64 | + Function Command data | |
| 57 | 65 | |
| 58 | 66 | Command 1 indicates disabling flow while 2 is enabling flow |
| 59 | 67 | |
| 60 | −Command types - | |
| 68 | +Command types | |
| 69 | + | |
| 70 | += ========================================== | |
| 61 | 71 | 0 for MAP command request |
| 62 | 72 | 1 is to acknowledge the receipt of a command |
| 63 | 73 | 2 is for unsupported commands |
| 64 | 74 | 3 is for error during processing of commands |
| 75 | += ========================================== | |
| 65 | 76 | |
| 66 | 77 | c. Aggregation |
| 67 | 78 | |
| @@ -71,9 +82,11 @@ packets and either ACK the MAP command or deliver the IP packet to the · 3 unmodified lines | ||
| 71 | 82 | network stack as needed |
| 72 | 83 | |
| 73 | 84 | MAP header|IP Packet|Optional padding|MAP header|IP Packet|Optional padding.... |
| 85 | + | |
| 74 | 86 | MAP header|IP Packet|Optional padding|MAP header|Command Packet|Optional pad... |
| 75 | 87 | |
| 76 | 88 | 3. Userspace configuration |
| 89 | +========================== | |
| 77 | 90 | |
| 78 | 91 | rmnet userspace configuration is done through netlink library librmnetctl |
| 79 | 92 | and command line utility rmnetcli. Utility is hosted in codeaurora forum git. |
| @@ -0,0 +1,222 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +=================== | |
| 4 | +SB100 device driver | |
| 5 | +=================== | |
| 6 | + | |
| 7 | +sb1000 is a module network device driver for the General Instrument (also known | |
| 8 | +as NextLevel) SURFboard1000 internal cable modem board. This is an ISA card | |
| 9 | +which is used by a number of cable TV companies to provide cable modem access. | |
| 10 | +It's a one-way downstream-only cable modem, meaning that your upstream net link | |
| 11 | +is provided by your regular phone modem. | |
| 12 | + | |
| 13 | +This driver was written by Franco Venturi <fventuri@mediaone.net>. He deserves | |
| 14 | +a great deal of thanks for this wonderful piece of code! | |
| 15 | + | |
| 16 | +Needed tools | |
| 17 | +============ | |
| 18 | + | |
| 19 | +Support for this device is now a part of the standard Linux kernel. The | |
| 20 | +driver source code file is drivers/net/sb1000.c. In addition to this | |
| 21 | +you will need: | |
| 22 | + | |
| 23 | +1. The "cmconfig" program. This is a utility which supplements "ifconfig" | |
| 24 | + to configure the cable modem and network interface (usually called "cm0"); | |
| 25 | + | |
| 26 | +2. Several PPP scripts which live in /etc/ppp to make connecting via your | |
| 27 | + cable modem easy. | |
| 28 | + | |
| 29 | + These utilities can be obtained from: | |
| 30 | + | |
| 31 | + http://www.jacksonville.net/~fventuri/ | |
| 32 | + | |
| 33 | + in Franco's original source code distribution .tar.gz file. Support for | |
| 34 | + the sb1000 driver can be found at: | |
| 35 | + | |
| 36 | + - http://web.archive.org/web/%2E/http://home.adelphia.net/~siglercm/sb1000.html | |
| 37 | + - http://web.archive.org/web/%2E/http://linuxpower.cx/~cable/ | |
| 38 | + | |
| 39 | + along with these utilities. | |
| 40 | + | |
| 41 | +3. The standard isapnp tools. These are necessary to configure your SB1000 | |
| 42 | + card at boot time (or afterwards by hand) since it's a PnP card. | |
| 43 | + | |
| 44 | + If you don't have these installed as a standard part of your Linux | |
| 45 | + distribution, you can find them at: | |
| 46 | + | |
| 47 | + http://www.roestock.demon.co.uk/isapnptools/ | |
| 48 | + | |
| 49 | + or check your Linux distribution binary CD or their web site. For help with | |
| 50 | + isapnp, pnpdump, or /etc/isapnp.conf, go to: | |
| 51 | + | |
| 52 | + http://www.roestock.demon.co.uk/isapnptools/isapnpfaq.html | |
| 53 | + | |
| 54 | +Using the driver | |
| 55 | +================ | |
| 56 | + | |
| 57 | +To make the SB1000 card work, follow these steps: | |
| 58 | + | |
| 59 | +1. Run ``make config``, or ``make menuconfig``, or ``make xconfig``, whichever | |
| 60 | + you prefer, in the top kernel tree directory to set up your kernel | |
| 61 | + configuration. Make sure to say "Y" to "Prompt for development drivers" | |
| 62 | + and to say "M" to the sb1000 driver. Also say "Y" or "M" to all the standard | |
| 63 | + networking questions to get TCP/IP and PPP networking support. | |
| 64 | + | |
| 65 | +2. **BEFORE** you build the kernel, edit drivers/net/sb1000.c. Make sure | |
| 66 | + to redefine the value of READ_DATA_PORT to match the I/O address used | |
| 67 | + by isapnp to access your PnP cards. This is the value of READPORT in | |
| 68 | + /etc/isapnp.conf or given by the output of pnpdump. | |
| 69 | + | |
| 70 | +3. Build and install the kernel and modules as usual. | |
| 71 | + | |
| 72 | +4. Boot your new kernel following the usual procedures. | |
| 73 | + | |
| 74 | +5. Set up to configure the new SB1000 PnP card by capturing the output | |
| 75 | + of "pnpdump" to a file and editing this file to set the correct I/O ports, | |
| 76 | + IRQ, and DMA settings for all your PnP cards. Make sure none of the settings | |
| 77 | + conflict with one another. Then test this configuration by running the | |
| 78 | + "isapnp" command with your new config file as the input. Check for | |
| 79 | + errors and fix as necessary. (As an aside, I use I/O ports 0x110 and | |
| 80 | + 0x310 and IRQ 11 for my SB1000 card and these work well for me. YMMV.) | |
| 81 | + Then save the finished config file as /etc/isapnp.conf for proper | |
| 82 | + configuration on subsequent reboots. | |
| 83 | + | |
| 84 | +6. Download the original file sb1000-1.1.2.tar.gz from Franco's site or one of | |
| 85 | + the others referenced above. As root, unpack it into a temporary directory | |
| 86 | + and do a ``make cmconfig`` and then ``install -c cmconfig /usr/local/sbin``. | |
| 87 | + Don't do ``make install`` because it expects to find all the utilities built | |
| 88 | + and ready for installation, not just cmconfig. | |
| 89 | + | |
| 90 | +7. As root, copy all the files under the ppp/ subdirectory in Franco's | |
| 91 | + tar file into /etc/ppp, being careful not to overwrite any files that are | |
| 92 | + already in there. Then modify ppp@gi-on to set the correct login name, | |
| 93 | + phone number, and frequency for the cable modem. Also edit pap-secrets | |
| 94 | + to specify your login name and password and any site-specific information | |
| 95 | + you need. | |
| 96 | + | |
| 97 | +8. Be sure to modify /etc/ppp/firewall to use ipchains instead of | |
| 98 | + the older ipfwadm commands from the 2.0.x kernels. There's a neat utility to | |
| 99 | + convert ipfwadm commands to ipchains commands: | |
| 100 | + | |
| 101 | + http://users.dhp.com/~whisper/ipfwadm2ipchains/ | |
| 102 | + | |
| 103 | + You may also wish to modify the firewall script to implement a different | |
| 104 | + firewalling scheme. | |
| 105 | + | |
| 106 | +9. Start the PPP connection via the script /etc/ppp/ppp@gi-on. You must be | |
| 107 | + root to do this. It's better to use a utility like sudo to execute | |
| 108 | + frequently used commands like this with root permissions if possible. If you | |
| 109 | + connect successfully the cable modem interface will come up and you'll see a | |
| 110 | + driver message like this at the console:: | |
| 111 | + | |
| 112 | + cm0: sb1000 at (0x110,0x310), csn 1, S/N 0x2a0d16d8, IRQ 11. | |
| 113 | + sb1000.c:v1.1.2 6/01/98 (fventuri@mediaone.net) | |
| 114 | + | |
| 115 | + The "ifconfig" command should show two new interfaces, ppp0 and cm0. | |
| 116 | + | |
| 117 | + The command "cmconfig cm0" will give you information about the cable modem | |
| 118 | + interface. | |
| 119 | + | |
| 120 | +10. Try pinging a site via ``ping -c 5 www.yahoo.com``, for example. You should | |
| 121 | + see packets received. | |
| 122 | + | |
| 123 | +11. If you can't get site names (like www.yahoo.com) to resolve into | |
| 124 | + IP addresses (like 204.71.200.67), be sure your /etc/resolv.conf file | |
| 125 | + has no syntax errors and has the right nameserver IP addresses in it. | |
| 126 | + If this doesn't help, try something like ``ping -c 5 204.71.200.67`` to | |
| 127 | + see if the networking is running but the DNS resolution is where the | |
| 128 | + problem lies. | |
| 129 | + | |
| 130 | +12. If you still have problems, go to the support web sites mentioned above | |
| 131 | + and read the information and documentation there. | |
| 132 | + | |
| 133 | +Common problems | |
| 134 | +=============== | |
| 135 | + | |
| 136 | +1. Packets go out on the ppp0 interface but don't come back on the cm0 | |
| 137 | + interface. It looks like I'm connected but I can't even ping any | |
| 138 | + numerical IP addresses. (This happens predominantly on Debian systems due | |
| 139 | + to a default boot-time configuration script.) | |
| 140 | + | |
| 141 | +Solution | |
| 142 | + As root ``echo 0 > /proc/sys/net/ipv4/conf/cm0/rp_filter`` so it | |
| 143 | + can share the same IP address as the ppp0 interface. Note that this | |
| 144 | + command should probably be added to the /etc/ppp/cablemodem script | |
| 145 | + *right*between* the "/sbin/ifconfig" and "/sbin/cmconfig" commands. | |
| 146 | + You may need to do this to /proc/sys/net/ipv4/conf/ppp0/rp_filter as well. | |
| 147 | + If you do this to /proc/sys/net/ipv4/conf/default/rp_filter on each reboot | |
| 148 | + (in rc.local or some such) then any interfaces can share the same IP | |
| 149 | + addresses. | |
| 150 | + | |
| 151 | +2. I get "unresolved symbol" error messages on executing ``insmod sb1000.o``. | |
| 152 | + | |
| 153 | +Solution | |
| 154 | + You probably have a non-matching kernel source tree and | |
| 155 | + /usr/include/linux and /usr/include/asm header files. Make sure you | |
| 156 | + install the correct versions of the header files in these two directories. | |
| 157 | + Then rebuild and reinstall the kernel. | |
| 158 | + | |
| 159 | +3. When isapnp runs it reports an error, and my SB1000 card isn't working. | |
| 160 | + | |
| 161 | +Solution | |
| 162 | + There's a problem with later versions of isapnp using the "(CHECK)" | |
| 163 | + option in the lines that allocate the two I/O addresses for the SB1000 card. | |
| 164 | + This first popped up on RH 6.0. Delete "(CHECK)" for the SB1000 I/O addresses. | |
| 165 | + Make sure they don't conflict with any other pieces of hardware first! Then | |
| 166 | + rerun isapnp and go from there. | |
| 167 | + | |
| 168 | +4. I can't execute the /etc/ppp/ppp@gi-on file. | |
| 169 | + | |
| 170 | +Solution | |
| 171 | + As root do ``chmod ug+x /etc/ppp/ppp@gi-on``. | |
| 172 | + | |
| 173 | +5. The firewall script isn't working (with 2.2.x and higher kernels). | |
| 174 | + | |
| 175 | +Solution | |
| 176 | + Use the ipfwadm2ipchains script referenced above to convert the | |
| 177 | + /etc/ppp/firewall script from the deprecated ipfwadm commands to ipchains. | |
| 178 | + | |
| 179 | +6. I'm getting *tons* of firewall deny messages in the /var/kern.log, | |
| 180 | + /var/messages, and/or /var/syslog files, and they're filling up my /var | |
| 181 | + partition!!! | |
| 182 | + | |
| 183 | +Solution | |
| 184 | + First, tell your ISP that you're receiving DoS (Denial of Service) | |
| 185 | + and/or portscanning (UDP connection attempts) attacks! Look over the deny | |
| 186 | + messages to figure out what the attack is and where it's coming from. Next, | |
| 187 | + edit /etc/ppp/cablemodem and make sure the ",nobroadcast" option is turned on | |
| 188 | + to the "cmconfig" command (uncomment that line). If you're not receiving these | |
| 189 | + denied packets on your broadcast interface (IP address xxx.yyy.zzz.255 | |
| 190 | + typically), then someone is attacking your machine in particular. Be careful | |
| 191 | + out there.... | |
| 192 | + | |
| 193 | +7. Everything seems to work fine but my computer locks up after a while | |
| 194 | + (and typically during a lengthy download through the cable modem)! | |
| 195 | + | |
| 196 | +Solution | |
| 197 | + You may need to add a short delay in the driver to 'slow down' the | |
| 198 | + SURFboard because your PC might not be able to keep up with the transfer rate | |
| 199 | + of the SB1000. To do this, it's probably best to download Franco's | |
| 200 | + sb1000-1.1.2.tar.gz archive and build and install sb1000.o manually. You'll | |
| 201 | + want to edit the 'Makefile' and look for the 'SB1000_DELAY' | |
| 202 | + define. Uncomment those 'CFLAGS' lines (and comment out the default ones) | |
| 203 | + and try setting the delay to something like 60 microseconds with: | |
| 204 | + '-DSB1000_DELAY=60'. Then do ``make`` and as root ``make install`` and try | |
| 205 | + it out. If it still doesn't work or you like playing with the driver, you may | |
| 206 | + try other numbers. Remember though that the higher the delay, the slower the | |
| 207 | + driver (which slows down the rest of the PC too when it is actively | |
| 208 | + used). Thanks to Ed Daiga for this tip! | |
| 209 | + | |
| 210 | +Credits | |
| 211 | +======= | |
| 212 | + | |
| 213 | +This README came from Franco Venturi's original README file which is | |
| 214 | +still supplied with his driver .tar.gz archive. I and all other sb1000 users | |
| 215 | +owe Franco a tremendous "Thank you!" Additional thanks goes to Carl Patten | |
| 216 | +and Ralph Bonnell who are now managing the Linux SB1000 web site, and to | |
| 217 | +the SB1000 users who reported and helped debug the common problems listed | |
| 218 | +above. | |
| 219 | + | |
| 220 | + | |
| 221 | + Clemmitt Sigler | |
| 222 | + csigler@vt.edu | |
| @@ -1,207 +0,0 @@ | ||
| 1 | −sb1000 is a module network device driver for the General Instrument (also known | |
| 2 | −as NextLevel) SURFboard1000 internal cable modem board. This is an ISA card | |
| 3 | −which is used by a number of cable TV companies to provide cable modem access. | |
| 4 | −It's a one-way downstream-only cable modem, meaning that your upstream net link | |
| 5 | −is provided by your regular phone modem. | |
| 6 | − | |
| 7 | −This driver was written by Franco Venturi <fventuri@mediaone.net>. He deserves | |
| 8 | −a great deal of thanks for this wonderful piece of code! | |
| 9 | − | |
| 10 | −----------------------------------------------------------------------------- | |
| 11 | − | |
| 12 | −Support for this device is now a part of the standard Linux kernel. The | |
| 13 | −driver source code file is drivers/net/sb1000.c. In addition to this | |
| 14 | −you will need: | |
| 15 | − | |
| 16 | −1.) The "cmconfig" program. This is a utility which supplements "ifconfig" | |
| 17 | −to configure the cable modem and network interface (usually called "cm0"); | |
| 18 | −and | |
| 19 | − | |
| 20 | −2.) Several PPP scripts which live in /etc/ppp to make connecting via your | |
| 21 | −cable modem easy. | |
| 22 | − | |
| 23 | − These utilities can be obtained from: | |
| 24 | − | |
| 25 | − http://www.jacksonville.net/~fventuri/ | |
| 26 | − | |
| 27 | − in Franco's original source code distribution .tar.gz file. Support for | |
| 28 | − the sb1000 driver can be found at: | |
| 29 | − | |
| 30 | − http://web.archive.org/web/*/http://home.adelphia.net/~siglercm/sb1000.html | |
| 31 | − http://web.archive.org/web/*/http://linuxpower.cx/~cable/ | |
| 32 | − | |
| 33 | − along with these utilities. | |
| 34 | − | |
| 35 | −3.) The standard isapnp tools. These are necessary to configure your SB1000 | |
| 36 | −card at boot time (or afterwards by hand) since it's a PnP card. | |
| 37 | − | |
| 38 | − If you don't have these installed as a standard part of your Linux | |
| 39 | − distribution, you can find them at: | |
| 40 | − | |
| 41 | − http://www.roestock.demon.co.uk/isapnptools/ | |
| 42 | − | |
| 43 | − or check your Linux distribution binary CD or their web site. For help with | |
| 44 | − isapnp, pnpdump, or /etc/isapnp.conf, go to: | |
| 45 | − | |
| 46 | − http://www.roestock.demon.co.uk/isapnptools/isapnpfaq.html | |
| 47 | − | |
| 48 | −----------------------------------------------------------------------------- | |
| 49 | − | |
| 50 | −To make the SB1000 card work, follow these steps: | |
| 51 | − | |
| 52 | −1.) Run `make config', or `make menuconfig', or `make xconfig', whichever | |
| 53 | −you prefer, in the top kernel tree directory to set up your kernel | |
| 54 | −configuration. Make sure to say "Y" to "Prompt for development drivers" | |
| 55 | −and to say "M" to the sb1000 driver. Also say "Y" or "M" to all the standard | |
| 56 | −networking questions to get TCP/IP and PPP networking support. | |
| 57 | − | |
| 58 | −2.) *BEFORE* you build the kernel, edit drivers/net/sb1000.c. Make sure | |
| 59 | −to redefine the value of READ_DATA_PORT to match the I/O address used | |
| 60 | −by isapnp to access your PnP cards. This is the value of READPORT in | |
| 61 | −/etc/isapnp.conf or given by the output of pnpdump. | |
| 62 | − | |
| 63 | −3.) Build and install the kernel and modules as usual. | |
| 64 | − | |
| 65 | −4.) Boot your new kernel following the usual procedures. | |
| 66 | − | |
| 67 | −5.) Set up to configure the new SB1000 PnP card by capturing the output | |
| 68 | −of "pnpdump" to a file and editing this file to set the correct I/O ports, | |
| 69 | −IRQ, and DMA settings for all your PnP cards. Make sure none of the settings | |
| 70 | −conflict with one another. Then test this configuration by running the | |
| 71 | −"isapnp" command with your new config file as the input. Check for | |
| 72 | −errors and fix as necessary. (As an aside, I use I/O ports 0x110 and | |
| 73 | −0x310 and IRQ 11 for my SB1000 card and these work well for me. YMMV.) | |
| 74 | −Then save the finished config file as /etc/isapnp.conf for proper configuration | |
| 75 | −on subsequent reboots. | |
| 76 | − | |
| 77 | −6.) Download the original file sb1000-1.1.2.tar.gz from Franco's site or one of | |
| 78 | −the others referenced above. As root, unpack it into a temporary directory and | |
| 79 | −do a `make cmconfig' and then `install -c cmconfig /usr/local/sbin'. Don't do | |
| 80 | −`make install' because it expects to find all the utilities built and ready for | |
| 81 | −installation, not just cmconfig. | |
| 82 | − | |
| 83 | −7.) As root, copy all the files under the ppp/ subdirectory in Franco's | |
| 84 | −tar file into /etc/ppp, being careful not to overwrite any files that are | |
| 85 | −already in there. Then modify ppp@gi-on to set the correct login name, | |
| 86 | −phone number, and frequency for the cable modem. Also edit pap-secrets | |
| 87 | −to specify your login name and password and any site-specific information | |
| 88 | −you need. | |
| 89 | − | |
| 90 | −8.) Be sure to modify /etc/ppp/firewall to use ipchains instead of | |
| 91 | −the older ipfwadm commands from the 2.0.x kernels. There's a neat utility to | |
| 92 | −convert ipfwadm commands to ipchains commands: | |
| 93 | − | |
| 94 | − http://users.dhp.com/~whisper/ipfwadm2ipchains/ | |
| 95 | − | |
| 96 | −You may also wish to modify the firewall script to implement a different | |
| 97 | −firewalling scheme. | |
| 98 | − | |
| 99 | −9.) Start the PPP connection via the script /etc/ppp/ppp@gi-on. You must be | |
| 100 | −root to do this. It's better to use a utility like sudo to execute | |
| 101 | −frequently used commands like this with root permissions if possible. If you | |
| 102 | −connect successfully the cable modem interface will come up and you'll see a | |
| 103 | −driver message like this at the console: | |
| 104 | − | |
| 105 | − cm0: sb1000 at (0x110,0x310), csn 1, S/N 0x2a0d16d8, IRQ 11. | |
| 106 | − sb1000.c:v1.1.2 6/01/98 (fventuri@mediaone.net) | |
| 107 | − | |
| 108 | −The "ifconfig" command should show two new interfaces, ppp0 and cm0. | |
| 109 | −The command "cmconfig cm0" will give you information about the cable modem | |
| 110 | −interface. | |
| 111 | − | |
| 112 | −10.) Try pinging a site via `ping -c 5 www.yahoo.com', for example. You should | |
| 113 | −see packets received. | |
| 114 | − | |
| 115 | −11.) If you can't get site names (like www.yahoo.com) to resolve into | |
| 116 | −IP addresses (like 204.71.200.67), be sure your /etc/resolv.conf file | |
| 117 | −has no syntax errors and has the right nameserver IP addresses in it. | |
| 118 | −If this doesn't help, try something like `ping -c 5 204.71.200.67' to | |
| 119 | −see if the networking is running but the DNS resolution is where the | |
| 120 | −problem lies. | |
| 121 | − | |
| 122 | −12.) If you still have problems, go to the support web sites mentioned above | |
| 123 | −and read the information and documentation there. | |
| 124 | − | |
| 125 | −----------------------------------------------------------------------------- | |
| 126 | − | |
| 127 | −Common problems: | |
| 128 | − | |
| 129 | −1.) Packets go out on the ppp0 interface but don't come back on the cm0 | |
| 130 | −interface. It looks like I'm connected but I can't even ping any | |
| 131 | −numerical IP addresses. (This happens predominantly on Debian systems due | |
| 132 | −to a default boot-time configuration script.) | |
| 133 | − | |
| 134 | −Solution -- As root `echo 0 > /proc/sys/net/ipv4/conf/cm0/rp_filter' so it | |
| 135 | −can share the same IP address as the ppp0 interface. Note that this | |
| 136 | −command should probably be added to the /etc/ppp/cablemodem script | |
| 137 | −*right*between* the "/sbin/ifconfig" and "/sbin/cmconfig" commands. | |
| 138 | −You may need to do this to /proc/sys/net/ipv4/conf/ppp0/rp_filter as well. | |
| 139 | −If you do this to /proc/sys/net/ipv4/conf/default/rp_filter on each reboot | |
| 140 | −(in rc.local or some such) then any interfaces can share the same IP | |
| 141 | −addresses. | |
| 142 | − | |
| 143 | −2.) I get "unresolved symbol" error messages on executing `insmod sb1000.o'. | |
| 144 | − | |
| 145 | −Solution -- You probably have a non-matching kernel source tree and | |
| 146 | −/usr/include/linux and /usr/include/asm header files. Make sure you | |
| 147 | −install the correct versions of the header files in these two directories. | |
| 148 | −Then rebuild and reinstall the kernel. | |
| 149 | − | |
| 150 | −3.) When isapnp runs it reports an error, and my SB1000 card isn't working. | |
| 151 | − | |
| 152 | −Solution -- There's a problem with later versions of isapnp using the "(CHECK)" | |
| 153 | −option in the lines that allocate the two I/O addresses for the SB1000 card. | |
| 154 | −This first popped up on RH 6.0. Delete "(CHECK)" for the SB1000 I/O addresses. | |
| 155 | −Make sure they don't conflict with any other pieces of hardware first! Then | |
| 156 | −rerun isapnp and go from there. | |
| 157 | − | |
| 158 | −4.) I can't execute the /etc/ppp/ppp@gi-on file. | |
| 159 | − | |
| 160 | −Solution -- As root do `chmod ug+x /etc/ppp/ppp@gi-on'. | |
| 161 | − | |
| 162 | −5.) The firewall script isn't working (with 2.2.x and higher kernels). | |
| 163 | − | |
| 164 | −Solution -- Use the ipfwadm2ipchains script referenced above to convert the | |
| 165 | −/etc/ppp/firewall script from the deprecated ipfwadm commands to ipchains. | |
| 166 | − | |
| 167 | −6.) I'm getting *tons* of firewall deny messages in the /var/kern.log, | |
| 168 | −/var/messages, and/or /var/syslog files, and they're filling up my /var | |
| 169 | −partition!!! | |
| 170 | − | |
| 171 | −Solution -- First, tell your ISP that you're receiving DoS (Denial of Service) | |
| 172 | −and/or portscanning (UDP connection attempts) attacks! Look over the deny | |
| 173 | −messages to figure out what the attack is and where it's coming from. Next, | |
| 174 | −edit /etc/ppp/cablemodem and make sure the ",nobroadcast" option is turned on | |
| 175 | −to the "cmconfig" command (uncomment that line). If you're not receiving these | |
| 176 | −denied packets on your broadcast interface (IP address xxx.yyy.zzz.255 | |
| 177 | −typically), then someone is attacking your machine in particular. Be careful | |
| 178 | −out there.... | |
| 179 | − | |
| 180 | −7.) Everything seems to work fine but my computer locks up after a while | |
| 181 | −(and typically during a lengthy download through the cable modem)! | |
| 182 | − | |
| 183 | −Solution -- You may need to add a short delay in the driver to 'slow down' the | |
| 184 | −SURFboard because your PC might not be able to keep up with the transfer rate | |
| 185 | −of the SB1000. To do this, it's probably best to download Franco's | |
| 186 | −sb1000-1.1.2.tar.gz archive and build and install sb1000.o manually. You'll | |
| 187 | −want to edit the 'Makefile' and look for the 'SB1000_DELAY' | |
| 188 | −define. Uncomment those 'CFLAGS' lines (and comment out the default ones) | |
| 189 | −and try setting the delay to something like 60 microseconds with: | |
| 190 | −'-DSB1000_DELAY=60'. Then do `make' and as root `make install' and try | |
| 191 | −it out. If it still doesn't work or you like playing with the driver, you may | |
| 192 | −try other numbers. Remember though that the higher the delay, the slower the | |
| 193 | −driver (which slows down the rest of the PC too when it is actively | |
| 194 | −used). Thanks to Ed Daiga for this tip! | |
| 195 | − | |
| 196 | −----------------------------------------------------------------------------- | |
| 197 | − | |
| 198 | −Credits: This README came from Franco Venturi's original README file which is | |
| 199 | −still supplied with his driver .tar.gz archive. I and all other sb1000 users | |
| 200 | −owe Franco a tremendous "Thank you!" Additional thanks goes to Carl Patten | |
| 201 | −and Ralph Bonnell who are now managing the Linux SB1000 web site, and to | |
| 202 | −the SB1000 users who reported and helped debug the common problems listed | |
| 203 | −above. | |
| 204 | − | |
| 205 | − | |
| 206 | − Clemmitt Sigler | |
| 207 | − csigler@vt.edu | |
| @@ -0,0 +1,48 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +================ | |
| 4 | +SMC 9xxxx Driver | |
| 5 | +================ | |
| 6 | + | |
| 7 | +Revision 0.12 | |
| 8 | + | |
| 9 | +3/5/96 | |
| 10 | + | |
| 11 | +Copyright 1996 Erik Stahlman | |
| 12 | + | |
| 13 | +Released under terms of the GNU General Public License. | |
| 14 | + | |
| 15 | +This file contains the instructions and caveats for my SMC9xxx driver. You | |
| 16 | +should not be using the driver without reading this file. | |
| 17 | + | |
| 18 | +Things to note about installation: | |
| 19 | + | |
| 20 | + 1. The driver should work on all kernels from 1.2.13 until 1.3.71. | |
| 21 | + (A kernel patch is supplied for 1.3.71 ) | |
| 22 | + | |
| 23 | + 2. If you include this into the kernel, you might need to change some | |
| 24 | + options, such as for forcing IRQ. | |
| 25 | + | |
| 26 | + | |
| 27 | + 3. To compile as a module, run 'make'. | |
| 28 | + Make will give you the appropriate options for various kernel support. | |
| 29 | + | |
| 30 | + 4. Loading the driver as a module:: | |
| 31 | + | |
| 32 | + use: insmod smc9194.o | |
| 33 | + optional parameters: | |
| 34 | + io=xxxx : your base address | |
| 35 | + irq=xx : your irq | |
| 36 | + ifport=x : 0 for whatever is default | |
| 37 | + 1 for twisted pair | |
| 38 | + 2 for AUI ( or BNC on some cards ) | |
| 39 | + | |
| 40 | +How to obtain the latest version? | |
| 41 | + | |
| 42 | +FTP: | |
| 43 | + ftp://fenris.campus.vt.edu/smc9/smc9-12.tar.gz | |
| 44 | + ftp://sfbox.vt.edu/filebox/F/fenris/smc9/smc9-12.tar.gz | |
| 45 | + | |
| 46 | + | |
| 47 | +Contacting me: | |
| 48 | + erik@mail.vt.edu | |
| @@ -1,42 +0,0 @@ | ||
| 1 | − | |
| 2 | −SMC 9xxxx Driver | |
| 3 | −Revision 0.12 | |
| 4 | −3/5/96 | |
| 5 | −Copyright 1996 Erik Stahlman | |
| 6 | −Released under terms of the GNU General Public License. | |
| 7 | − | |
| 8 | −This file contains the instructions and caveats for my SMC9xxx driver. You | |
| 9 | −should not be using the driver without reading this file. | |
| 10 | − | |
| 11 | −Things to note about installation: | |
| 12 | − | |
| 13 | − 1. The driver should work on all kernels from 1.2.13 until 1.3.71. | |
| 14 | − (A kernel patch is supplied for 1.3.71 ) | |
| 15 | − | |
| 16 | − 2. If you include this into the kernel, you might need to change some | |
| 17 | − options, such as for forcing IRQ. | |
| 18 | − | |
| 19 | − | |
| 20 | − 3. To compile as a module, run 'make' . | |
| 21 | − Make will give you the appropriate options for various kernel support. | |
| 22 | − | |
| 23 | − 4. Loading the driver as a module : | |
| 24 | − | |
| 25 | − use: insmod smc9194.o | |
| 26 | − optional parameters: | |
| 27 | − io=xxxx : your base address | |
| 28 | − irq=xx : your irq | |
| 29 | − ifport=x : 0 for whatever is default | |
| 30 | − 1 for twisted pair | |
| 31 | − 2 for AUI ( or BNC on some cards ) | |
| 32 | − | |
| 33 | −How to obtain the latest version? | |
| 34 | − | |
| 35 | −FTP: | |
| 36 | − ftp://fenris.campus.vt.edu/smc9/smc9-12.tar.gz | |
| 37 | − ftp://sfbox.vt.edu/filebox/F/fenris/smc9/smc9-12.tar.gz | |
| 38 | − | |
| 39 | − | |
| 40 | −Contacting me: | |
| 41 | − erik@mail.vt.edu | |
| 42 | − | |
| @@ -0,0 +1,587 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +====================================== | |
| 4 | +Texas Instruments CPSW ethernet driver | |
| 5 | +====================================== | |
| 6 | + | |
| 7 | +Multiqueue & CBS & MQPRIO | |
| 8 | +========================= | |
| 9 | + | |
| 10 | + | |
| 11 | +The cpsw has 3 CBS shapers for each external ports. This document | |
| 12 | +describes MQPRIO and CBS Qdisc offload configuration for cpsw driver | |
| 13 | +based on examples. It potentially can be used in audio video bridging | |
| 14 | +(AVB) and time sensitive networking (TSN). | |
| 15 | + | |
| 16 | +The following examples were tested on AM572x EVM and BBB boards. | |
| 17 | + | |
| 18 | +Test setup | |
| 19 | +========== | |
| 20 | + | |
| 21 | +Under consideration two examples with AM572x EVM running cpsw driver | |
| 22 | +in dual_emac mode. | |
| 23 | + | |
| 24 | +Several prerequisites: | |
| 25 | + | |
| 26 | +- TX queues must be rated starting from txq0 that has highest priority | |
| 27 | +- Traffic classes are used starting from 0, that has highest priority | |
| 28 | +- CBS shapers should be used with rated queues | |
| 29 | +- The bandwidth for CBS shapers has to be set a little bit more then | |
| 30 | + potential incoming rate, thus, rate of all incoming tx queues has | |
| 31 | + to be a little less | |
| 32 | +- Real rates can differ, due to discreetness | |
| 33 | +- Map skb-priority to txq is not enough, also skb-priority to l2 prio | |
| 34 | + map has to be created with ip or vconfig tool | |
| 35 | +- Any l2/socket prio (0 - 7) for classes can be used, but for | |
| 36 | + simplicity default values are used: 3 and 2 | |
| 37 | +- only 2 classes tested: A and B, but checked and can work with more, | |
| 38 | + maximum allowed 4, but only for 3 rate can be set. | |
| 39 | + | |
| 40 | +Test setup for examples | |
| 41 | +======================= | |
| 42 | + | |
| 43 | +:: | |
| 44 | + | |
| 45 | + +-------------------------------+ | |
| 46 | + |--+ | | |
| 47 | + | | Workstation0 | | |
| 48 | + |E | MAC 18:03:73:66:87:42 | | |
| 49 | + +-----------------------------+ +--|t | | | |
| 50 | + | | 1 | E | | |h |./tsn_listener -d \ | | |
| 51 | + | Target board: | 0 | t |--+ |0 | 18:03:73:66:87:42 -i eth0 \| | |
| 52 | + | AM572x EVM | 0 | h | | | -s 1500 | | |
| 53 | + | | 0 | 0 | |--+ | | |
| 54 | + | Only 2 classes: |Mb +---| +-------------------------------+ | |
| 55 | + | class A, class B | | | |
| 56 | + | | +---| +-------------------------------+ | |
| 57 | + | | 1 | E | |--+ | | |
| 58 | + | | 0 | t | | | Workstation1 | | |
| 59 | + | | 0 | h |--+ |E | MAC 20:cf:30:85:7d:fd | | |
| 60 | + | |Mb | 1 | +--|t | | | |
| 61 | + +-----------------------------+ |h |./tsn_listener -d \ | | |
| 62 | + |0 | 20:cf:30:85:7d:fd -i eth0 \| | |
| 63 | + | | -s 1500 | | |
| 64 | + |--+ | | |
| 65 | + +-------------------------------+ | |
| 66 | + | |
| 67 | + | |
| 68 | +Example 1: One port tx AVB configuration scheme for target board | |
| 69 | +---------------------------------------------------------------- | |
| 70 | + | |
| 71 | +(prints and scheme for AM572x evm, applicable for single port boards) | |
| 72 | + | |
| 73 | +- tc - traffic class | |
| 74 | +- txq - transmit queue | |
| 75 | +- p - priority | |
| 76 | +- f - fifo (cpsw fifo) | |
| 77 | +- S - shaper configured | |
| 78 | + | |
| 79 | +:: | |
| 80 | + | |
| 81 | + +------------------------------------------------------------------+ u | |
| 82 | + | +---------------+ +---------------+ +------+ +------+ | s | |
| 83 | + | | | | | | | | | | e | |
| 84 | + | | App 1 | | App 2 | | Apps | | Apps | | r | |
| 85 | + | | Class A | | Class B | | Rest | | Rest | | | |
| 86 | + | | Eth0 | | Eth0 | | Eth0 | | Eth1 | | s | |
| 87 | + | | VLAN100 | | VLAN100 | | | | | | | | p | |
| 88 | + | | 40 Mb/s | | 20 Mb/s | | | | | | | | a | |
| 89 | + | | SO_PRIORITY=3 | | SO_PRIORITY=2 | | | | | | | | c | |
| 90 | + | | | | | | | | | | | | | | e | |
| 91 | + | +---|-----------+ +---|-----------+ +---|--+ +---|--+ | | |
| 92 | + +-----|------------------|------------------|--------|-------------+ | |
| 93 | + +-+ +------------+ | | | |
| 94 | + | | +-----------------+ +--+ | |
| 95 | + | | | | | |
| 96 | + +---|-------|-------------|-----------------------|----------------+ | |
| 97 | + | +----+ +----+ +----+ +----+ +----+ | | |
| 98 | + | | p3 | | p2 | | p1 | | p0 | | p0 | | k | |
| 99 | + | \ / \ / \ / \ / \ / | e | |
| 100 | + | \ / \ / \ / \ / \ / | r | |
| 101 | + | \/ \/ \/ \/ \/ | n | |
| 102 | + | | | | | | e | |
| 103 | + | | | +-----+ | | l | |
| 104 | + | | | | | | | |
| 105 | + | +----+ +----+ +----+ +----+ | s | |
| 106 | + | |tc0 | |tc1 | |tc2 | |tc0 | | p | |
| 107 | + | \ / \ / \ / \ / | a | |
| 108 | + | \ / \ / \ / \ / | c | |
| 109 | + | \/ \/ \/ \/ | e | |
| 110 | + | | | +-----+ | | | |
| 111 | + | | | | | | | | |
| 112 | + | | | | | | | | |
| 113 | + | | | | | | | | |
| 114 | + | +----+ +----+ +----+ +----+ +----+ | | |
| 115 | + | |txq0| |txq1| |txq2| |txq3| |txq4| | | |
| 116 | + | \ / \ / \ / \ / \ / | | |
| 117 | + | \ / \ / \ / \ / \ / | | |
| 118 | + | \/ \/ \/ \/ \/ | | |
| 119 | + | +-|------|------|------|--+ +--|--------------+ | | |
| 120 | + | | | | | | | Eth0.100 | | Eth1 | | | |
| 121 | + +---|------|------|------|------------------------|----------------+ | |
| 122 | + | | | | | | |
| 123 | + p p p p | | |
| 124 | + 3 2 0-1, 4-7 <- L2 priority | | |
| 125 | + | | | | | | |
| 126 | + | | | | | | |
| 127 | + +---|------|------|------|------------------------|----------------+ | |
| 128 | + | | | | | |----------+ | | |
| 129 | + | +----+ +----+ +----+ +----+ +----+ | | |
| 130 | + | |dma7| |dma6| |dma5| |dma4| |dma3| | | |
| 131 | + | \ / \ / \ / \ / \ / | c | |
| 132 | + | \S / \S / \ / \ / \ / | p | |
| 133 | + | \/ \/ \/ \/ \/ | s | |
| 134 | + | | | | +----- | | w | |
| 135 | + | | | | | | | | |
| 136 | + | | | | | | | d | |
| 137 | + | +----+ +----+ +----+p p+----+ | r | |
| 138 | + | | | | | | |o o| | | i | |
| 139 | + | | f3 | | f2 | | f0 |r r| f0 | | v | |
| 140 | + | |tc0 | |tc1 | |tc2 |t t|tc0 | | e | |
| 141 | + | \CBS / \CBS / \CBS /1 2\CBS / | r | |
| 142 | + | \S / \S / \ / \ / | | |
| 143 | + | \/ \/ \/ \/ | | |
| 144 | + +------------------------------------------------------------------+ | |
| 145 | + | |
| 146 | + | |
| 147 | +1) :: | |
| 148 | + | |
| 149 | + | |
| 150 | + // Add 4 tx queues, for interface Eth0, and 1 tx queue for Eth1 | |
| 151 | + $ ethtool -L eth0 rx 1 tx 5 | |
| 152 | + rx unmodified, ignoring | |
| 153 | + | |
| 154 | +2) :: | |
| 155 | + | |
| 156 | + // Check if num of queues is set correctly: | |
| 157 | + $ ethtool -l eth0 | |
| 158 | + Channel parameters for eth0: | |
| 159 | + Pre-set maximums: | |
| 160 | + RX: 8 | |
| 161 | + TX: 8 | |
| 162 | + Other: 0 | |
| 163 | + Combined: 0 | |
| 164 | + Current hardware settings: | |
| 165 | + RX: 1 | |
| 166 | + TX: 5 | |
| 167 | + Other: 0 | |
| 168 | + Combined: 0 | |
| 169 | + | |
| 170 | +3) :: | |
| 171 | + | |
| 172 | + // TX queues must be rated starting from 0, so set bws for tx0 and tx1 | |
| 173 | + // Set rates 40 and 20 Mb/s appropriately. | |
| 174 | + // Pay attention, real speed can differ a bit due to discreetness. | |
| 175 | + // Leave last 2 tx queues not rated. | |
| 176 | + $ echo 40 > /sys/class/net/eth0/queues/tx-0/tx_maxrate | |
| 177 | + $ echo 20 > /sys/class/net/eth0/queues/tx-1/tx_maxrate | |
| 178 | + | |
| 179 | +4) :: | |
| 180 | + | |
| 181 | + // Check maximum rate of tx (cpdma) queues: | |
| 182 | + $ cat /sys/class/net/eth0/queues/tx-*/tx_maxrate | |
| 183 | + 40 | |
| 184 | + 20 | |
| 185 | + 0 | |
| 186 | + 0 | |
| 187 | + 0 | |
| 188 | + | |
| 189 | +5) :: | |
| 190 | + | |
| 191 | + // Map skb->priority to traffic class: | |
| 192 | + // 3pri -> tc0, 2pri -> tc1, (0,1,4-7)pri -> tc2 | |
| 193 | + // Map traffic class to transmit queue: | |
| 194 | + // tc0 -> txq0, tc1 -> txq1, tc2 -> (txq2, txq3) | |
| 195 | + $ tc qdisc replace dev eth0 handle 100: parent root mqprio num_tc 3 \ | |
| 196 | + map 2 2 1 0 2 2 2 2 2 2 2 2 2 2 2 2 queues 1@0 1@1 2@2 hw 1 | |
| 197 | + | |
| 198 | +5a) :: | |
| 199 | + | |
| 200 | + // As two interface sharing same set of tx queues, assign all traffic | |
| 201 | + // coming to interface Eth1 to separate queue in order to not mix it | |
| 202 | + // with traffic from interface Eth0, so use separate txq to send | |
| 203 | + // packets to Eth1, so all prio -> tc0 and tc0 -> txq4 | |
| 204 | + // Here hw 0, so here still default configuration for eth1 in hw | |
| 205 | + $ tc qdisc replace dev eth1 handle 100: parent root mqprio num_tc 1 \ | |
| 206 | + map 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 queues 1@4 hw 0 | |
| 207 | + | |
| 208 | +6) :: | |
| 209 | + | |
| 210 | + // Check classes settings | |
| 211 | + $ tc -g class show dev eth0 | |
| 212 | + +---(100:ffe2) mqprio | |
| 213 | + | +---(100:3) mqprio | |
| 214 | + | +---(100:4) mqprio | |
| 215 | + | | |
| 216 | + +---(100:ffe1) mqprio | |
| 217 | + | +---(100:2) mqprio | |
| 218 | + | | |
| 219 | + +---(100:ffe0) mqprio | |
| 220 | + +---(100:1) mqprio | |
| 221 | + | |
| 222 | + $ tc -g class show dev eth1 | |
| 223 | + +---(100:ffe0) mqprio | |
| 224 | + +---(100:5) mqprio | |
| 225 | + | |
| 226 | +7) :: | |
| 227 | + | |
| 228 | + // Set rate for class A - 41 Mbit (tc0, txq0) using CBS Qdisc | |
| 229 | + // Set it +1 Mb for reserve (important!) | |
| 230 | + // here only idle slope is important, others arg are ignored | |
| 231 | + // Pay attention, real speed can differ a bit due to discreetness | |
| 232 | + $ tc qdisc add dev eth0 parent 100:1 cbs locredit -1438 \ | |
| 233 | + hicredit 62 sendslope -959000 idleslope 41000 offload 1 | |
| 234 | + net eth0: set FIFO3 bw = 50 | |
| 235 | + | |
| 236 | +8) :: | |
| 237 | + | |
| 238 | + // Set rate for class B - 21 Mbit (tc1, txq1) using CBS Qdisc: | |
| 239 | + // Set it +1 Mb for reserve (important!) | |
| 240 | + $ tc qdisc add dev eth0 parent 100:2 cbs locredit -1468 \ | |
| 241 | + hicredit 65 sendslope -979000 idleslope 21000 offload 1 | |
| 242 | + net eth0: set FIFO2 bw = 30 | |
| 243 | + | |
| 244 | +9) :: | |
| 245 | + | |
| 246 | + // Create vlan 100 to map sk->priority to vlan qos | |
| 247 | + $ ip link add link eth0 name eth0.100 type vlan id 100 | |
| 248 | + 8021q: 802.1Q VLAN Support v1.8 | |
| 249 | + 8021q: adding VLAN 0 to HW filter on device eth0 | |
| 250 | + 8021q: adding VLAN 0 to HW filter on device eth1 | |
| 251 | + net eth0: Adding vlanid 100 to vlan filter | |
| 252 | + | |
| 253 | +10) :: | |
| 254 | + | |
| 255 | + // Map skb->priority to L2 prio, 1 to 1 | |
| 256 | + $ ip link set eth0.100 type vlan \ | |
| 257 | + egress 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7 | |
| 258 | + | |
| 259 | +11) :: | |
| 260 | + | |
| 261 | + // Check egress map for vlan 100 | |
| 262 | + $ cat /proc/net/vlan/eth0.100 | |
| 263 | + [...] | |
| 264 | + INGRESS priority mappings: 0:0 1:0 2:0 3:0 4:0 5:0 6:0 7:0 | |
| 265 | + EGRESS priority mappings: 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7 | |
| 266 | + | |
| 267 | +12) :: | |
| 268 | + | |
| 269 | + // Run your appropriate tools with socket option "SO_PRIORITY" | |
| 270 | + // to 3 for class A and/or to 2 for class B | |
| 271 | + // (I took at https://www.spinics.net/lists/netdev/msg460869.html) | |
| 272 | + ./tsn_talker -d 18:03:73:66:87:42 -i eth0.100 -p3 -s 1500& | |
| 273 | + ./tsn_talker -d 18:03:73:66:87:42 -i eth0.100 -p2 -s 1500& | |
| 274 | + | |
| 275 | +13) :: | |
| 276 | + | |
| 277 | + // run your listener on workstation (should be in same vlan) | |
| 278 | + // (I took at https://www.spinics.net/lists/netdev/msg460869.html) | |
| 279 | + ./tsn_listener -d 18:03:73:66:87:42 -i enp5s0 -s 1500 | |
| 280 | + Receiving data rate: 39012 kbps | |
| 281 | + Receiving data rate: 39012 kbps | |
| 282 | + Receiving data rate: 39012 kbps | |
| 283 | + Receiving data rate: 39012 kbps | |
| 284 | + Receiving data rate: 39012 kbps | |
| 285 | + Receiving data rate: 39012 kbps | |
| 286 | + Receiving data rate: 39012 kbps | |
| 287 | + Receiving data rate: 39012 kbps | |
| 288 | + Receiving data rate: 39012 kbps | |
| 289 | + Receiving data rate: 39012 kbps | |
| 290 | + Receiving data rate: 39012 kbps | |
| 291 | + Receiving data rate: 39012 kbps | |
| 292 | + Receiving data rate: 39000 kbps | |
| 293 | + | |
| 294 | +14) :: | |
| 295 | + | |
| 296 | + // Restore default configuration if needed | |
| 297 | + $ ip link del eth0.100 | |
| 298 | + $ tc qdisc del dev eth1 root | |
| 299 | + $ tc qdisc del dev eth0 root | |
| 300 | + net eth0: Prev FIFO2 is shaped | |
| 301 | + net eth0: set FIFO3 bw = 0 | |
| 302 | + net eth0: set FIFO2 bw = 0 | |
| 303 | + $ ethtool -L eth0 rx 1 tx 1 | |
| 304 | + | |
| 305 | +Example 2: Two port tx AVB configuration scheme for target board | |
| 306 | +---------------------------------------------------------------- | |
| 307 | + | |
| 308 | +(prints and scheme for AM572x evm, for dual emac boards only) | |
| 309 | + | |
| 310 | +:: | |
| 311 | + | |
| 312 | + +------------------------------------------------------------------+ u | |
| 313 | + | +----------+ +----------+ +------+ +----------+ +----------+ | s | |
| 314 | + | | | | | | | | | | | | e | |
| 315 | + | | App 1 | | App 2 | | Apps | | App 3 | | App 4 | | r | |
| 316 | + | | Class A | | Class B | | Rest | | Class B | | Class A | | | |
| 317 | + | | Eth0 | | Eth0 | | | | | Eth1 | | Eth1 | | s | |
| 318 | + | | VLAN100 | | VLAN100 | | | | | VLAN100 | | VLAN100 | | p | |
| 319 | + | | 40 Mb/s | | 20 Mb/s | | | | | 10 Mb/s | | 30 Mb/s | | a | |
| 320 | + | | SO_PRI=3 | | SO_PRI=2 | | | | | SO_PRI=3 | | SO_PRI=2 | | c | |
| 321 | + | | | | | | | | | | | | | | | | | e | |
| 322 | + | +---|------+ +---|------+ +---|--+ +---|------+ +---|------+ | | |
| 323 | + +-----|-------------|-------------|---------|-------------|--------+ | |
| 324 | + +-+ +-------+ | +----------+ +----+ | |
| 325 | + | | +-------+------+ | | | |
| 326 | + | | | | | | | |
| 327 | + +---|-------|-------------|--------------|-------------|-------|---+ | |
| 328 | + | +----+ +----+ +----+ +----+ +----+ +----+ +----+ +----+ | | |
| 329 | + | | p3 | | p2 | | p1 | | p0 | | p0 | | p1 | | p2 | | p3 | | k | |
| 330 | + | \ / \ / \ / \ / \ / \ / \ / \ / | e | |
| 331 | + | \ / \ / \ / \ / \ / \ / \ / \ / | r | |
| 332 | + | \/ \/ \/ \/ \/ \/ \/ \/ | n | |
| 333 | + | | | | | | | | e | |
| 334 | + | | | +----+ +----+ | | | l | |
| 335 | + | | | | | | | | | |
| 336 | + | +----+ +----+ +----+ +----+ +----+ +----+ | s | |
| 337 | + | |tc0 | |tc1 | |tc2 | |tc2 | |tc1 | |tc0 | | p | |
| 338 | + | \ / \ / \ / \ / \ / \ / | a | |
| 339 | + | \ / \ / \ / \ / \ / \ / | c | |
| 340 | + | \/ \/ \/ \/ \/ \/ | e | |
| 341 | + | | | +-----+ +-----+ | | | | |
| 342 | + | | | | | | | | | | | |
| 343 | + | | | | | | | | | | | |
| 344 | + | | | | | E E | | | | | | |
| 345 | + | +----+ +----+ +----+ +----+ t t +----+ +----+ +----+ +----+ | | |
| 346 | + | |txq0| |txq1| |txq4| |txq5| h h |txq6| |txq7| |txq3| |txq2| | | |
| 347 | + | \ / \ / \ / \ / 0 1 \ / \ / \ / \ / | | |
| 348 | + | \ / \ / \ / \ / . . \ / \ / \ / \ / | | |
| 349 | + | \/ \/ \/ \/ 1 1 \/ \/ \/ \/ | | |
| 350 | + | +-|------|------|------|--+ 0 0 +-|------|------|------|--+ | | |
| 351 | + | | | | | | | 0 0 | | | | | | | | |
| 352 | + +---|------|------|------|---------------|------|------|------|----+ | |
| 353 | + | | | | | | | | | |
| 354 | + p p p p p p p p | |
| 355 | + 3 2 0-1, 4-7 <-L2 pri-> 0-1, 4-7 2 3 | |
| 356 | + | | | | | | | | | |
| 357 | + | | | | | | | | | |
| 358 | + +---|------|------|------|---------------|------|------|------|----+ | |
| 359 | + | | | | | | | | | | | |
| 360 | + | +----+ +----+ +----+ +----+ +----+ +----+ +----+ +----+ | | |
| 361 | + | |dma7| |dma6| |dma3| |dma2| |dma1| |dma0| |dma4| |dma5| | | |
| 362 | + | \ / \ / \ / \ / \ / \ / \ / \ / | c | |
| 363 | + | \S / \S / \ / \ / \ / \ / \S / \S / | p | |
| 364 | + | \/ \/ \/ \/ \/ \/ \/ \/ | s | |
| 365 | + | | | | +----- | | | | | w | |
| 366 | + | | | | | +----+ | | | | | |
| 367 | + | | | | | | | | | | d | |
| 368 | + | +----+ +----+ +----+p p+----+ +----+ +----+ | r | |
| 369 | + | | | | | | |o o| | | | | | | i | |
| 370 | + | | f3 | | f2 | | f0 |r CPSW r| f3 | | f2 | | f0 | | v | |
| 371 | + | |tc0 | |tc1 | |tc2 |t t|tc0 | |tc1 | |tc2 | | e | |
| 372 | + | \CBS / \CBS / \CBS /1 2\CBS / \CBS / \CBS / | r | |
| 373 | + | \S / \S / \ / \S / \S / \ / | | |
| 374 | + | \/ \/ \/ \/ \/ \/ | | |
| 375 | + +------------------------------------------------------------------+ | |
| 376 | + ========================================Eth==========================> | |
| 377 | + | |
| 378 | +1) :: | |
| 379 | + | |
| 380 | + // Add 8 tx queues, for interface Eth0, but they are common, so are accessed | |
| 381 | + // by two interfaces Eth0 and Eth1. | |
| 382 | + $ ethtool -L eth1 rx 1 tx 8 | |
| 383 | + rx unmodified, ignoring | |
| 384 | + | |
| 385 | +2) :: | |
| 386 | + | |
| 387 | + // Check if num of queues is set correctly: | |
| 388 | + $ ethtool -l eth0 | |
| 389 | + Channel parameters for eth0: | |
| 390 | + Pre-set maximums: | |
| 391 | + RX: 8 | |
| 392 | + TX: 8 | |
| 393 | + Other: 0 | |
| 394 | + Combined: 0 | |
| 395 | + Current hardware settings: | |
| 396 | + RX: 1 | |
| 397 | + TX: 8 | |
| 398 | + Other: 0 | |
| 399 | + Combined: 0 | |
| 400 | + | |
| 401 | +3) :: | |
| 402 | + | |
| 403 | + // TX queues must be rated starting from 0, so set bws for tx0 and tx1 for Eth0 | |
| 404 | + // and for tx2 and tx3 for Eth1. That is, rates 40 and 20 Mb/s appropriately | |
| 405 | + // for Eth0 and 30 and 10 Mb/s for Eth1. | |
| 406 | + // Real speed can differ a bit due to discreetness | |
| 407 | + // Leave last 4 tx queues as not rated | |
| 408 | + $ echo 40 > /sys/class/net/eth0/queues/tx-0/tx_maxrate | |
| 409 | + $ echo 20 > /sys/class/net/eth0/queues/tx-1/tx_maxrate | |
| 410 | + $ echo 30 > /sys/class/net/eth1/queues/tx-2/tx_maxrate | |
| 411 | + $ echo 10 > /sys/class/net/eth1/queues/tx-3/tx_maxrate | |
| 412 | + | |
| 413 | +4) :: | |
| 414 | + | |
| 415 | + // Check maximum rate of tx (cpdma) queues: | |
| 416 | + $ cat /sys/class/net/eth0/queues/tx-*/tx_maxrate | |
| 417 | + 40 | |
| 418 | + 20 | |
| 419 | + 30 | |
| 420 | + 10 | |
| 421 | + 0 | |
| 422 | + 0 | |
| 423 | + 0 | |
| 424 | + 0 | |
| 425 | + | |
| 426 | +5) :: | |
| 427 | + | |
| 428 | + // Map skb->priority to traffic class for Eth0: | |
| 429 | + // 3pri -> tc0, 2pri -> tc1, (0,1,4-7)pri -> tc2 | |
| 430 | + // Map traffic class to transmit queue: | |
| 431 | + // tc0 -> txq0, tc1 -> txq1, tc2 -> (txq4, txq5) | |
| 432 | + $ tc qdisc replace dev eth0 handle 100: parent root mqprio num_tc 3 \ | |
| 433 | + map 2 2 1 0 2 2 2 2 2 2 2 2 2 2 2 2 queues 1@0 1@1 2@4 hw 1 | |
| 434 | + | |
| 435 | +6) :: | |
| 436 | + | |
| 437 | + // Check classes settings | |
| 438 | + $ tc -g class show dev eth0 | |
| 439 | + +---(100:ffe2) mqprio | |
| 440 | + | +---(100:5) mqprio | |
| 441 | + | +---(100:6) mqprio | |
| 442 | + | | |
| 443 | + +---(100:ffe1) mqprio | |
| 444 | + | +---(100:2) mqprio | |
| 445 | + | | |
| 446 | + +---(100:ffe0) mqprio | |
| 447 | + +---(100:1) mqprio | |
| 448 | + | |
| 449 | +7) :: | |
| 450 | + | |
| 451 | + // Set rate for class A - 41 Mbit (tc0, txq0) using CBS Qdisc for Eth0 | |
| 452 | + // here only idle slope is important, others ignored | |
| 453 | + // Real speed can differ a bit due to discreetness | |
| 454 | + $ tc qdisc add dev eth0 parent 100:1 cbs locredit -1470 \ | |
| 455 | + hicredit 62 sendslope -959000 idleslope 41000 offload 1 | |
| 456 | + net eth0: set FIFO3 bw = 50 | |
| 457 | + | |
| 458 | +8) :: | |
| 459 | + | |
| 460 | + // Set rate for class B - 21 Mbit (tc1, txq1) using CBS Qdisc for Eth0 | |
| 461 | + $ tc qdisc add dev eth0 parent 100:2 cbs locredit -1470 \ | |
| 462 | + hicredit 65 sendslope -979000 idleslope 21000 offload 1 | |
| 463 | + net eth0: set FIFO2 bw = 30 | |
| 464 | + | |
| 465 | +9) :: | |
| 466 | + | |
| 467 | + // Create vlan 100 to map sk->priority to vlan qos for Eth0 | |
| 468 | + $ ip link add link eth0 name eth0.100 type vlan id 100 | |
| 469 | + net eth0: Adding vlanid 100 to vlan filter | |
| 470 | + | |
| 471 | +10) :: | |
| 472 | + | |
| 473 | + // Map skb->priority to L2 prio for Eth0.100, one to one | |
| 474 | + $ ip link set eth0.100 type vlan \ | |
| 475 | + egress 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7 | |
| 476 | + | |
| 477 | +11) :: | |
| 478 | + | |
| 479 | + // Check egress map for vlan 100 | |
| 480 | + $ cat /proc/net/vlan/eth0.100 | |
| 481 | + [...] | |
| 482 | + INGRESS priority mappings: 0:0 1:0 2:0 3:0 4:0 5:0 6:0 7:0 | |
| 483 | + EGRESS priority mappings: 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7 | |
| 484 | + | |
| 485 | +12) :: | |
| 486 | + | |
| 487 | + // Map skb->priority to traffic class for Eth1: | |
| 488 | + // 3pri -> tc0, 2pri -> tc1, (0,1,4-7)pri -> tc2 | |
| 489 | + // Map traffic class to transmit queue: | |
| 490 | + // tc0 -> txq2, tc1 -> txq3, tc2 -> (txq6, txq7) | |
| 491 | + $ tc qdisc replace dev eth1 handle 100: parent root mqprio num_tc 3 \ | |
| 492 | + map 2 2 1 0 2 2 2 2 2 2 2 2 2 2 2 2 queues 1@2 1@3 2@6 hw 1 | |
| 493 | + | |
| 494 | +13) :: | |
| 495 | + | |
| 496 | + // Check classes settings | |
| 497 | + $ tc -g class show dev eth1 | |
| 498 | + +---(100:ffe2) mqprio | |
| 499 | + | +---(100:7) mqprio | |
| 500 | + | +---(100:8) mqprio | |
| 501 | + | | |
| 502 | + +---(100:ffe1) mqprio | |
| 503 | + | +---(100:4) mqprio | |
| 504 | + | | |
| 505 | + +---(100:ffe0) mqprio | |
| 506 | + +---(100:3) mqprio | |
| 507 | + | |
| 508 | +14) :: | |
| 509 | + | |
| 510 | + // Set rate for class A - 31 Mbit (tc0, txq2) using CBS Qdisc for Eth1 | |
| 511 | + // here only idle slope is important, others ignored, but calculated | |
| 512 | + // for interface speed - 100Mb for eth1 port. | |
| 513 | + // Set it +1 Mb for reserve (important!) | |
| 514 | + $ tc qdisc add dev eth1 parent 100:3 cbs locredit -1035 \ | |
| 515 | + hicredit 465 sendslope -69000 idleslope 31000 offload 1 | |
| 516 | + net eth1: set FIFO3 bw = 31 | |
| 517 | + | |
| 518 | +15) :: | |
| 519 | + | |
| 520 | + // Set rate for class B - 11 Mbit (tc1, txq3) using CBS Qdisc for Eth1 | |
| 521 | + // Set it +1 Mb for reserve (important!) | |
| 522 | + $ tc qdisc add dev eth1 parent 100:4 cbs locredit -1335 \ | |
| 523 | + hicredit 405 sendslope -89000 idleslope 11000 offload 1 | |
| 524 | + net eth1: set FIFO2 bw = 11 | |
| 525 | + | |
| 526 | +16) :: | |
| 527 | + | |
| 528 | + // Create vlan 100 to map sk->priority to vlan qos for Eth1 | |
| 529 | + $ ip link add link eth1 name eth1.100 type vlan id 100 | |
| 530 | + net eth1: Adding vlanid 100 to vlan filter | |
| 531 | + | |
| 532 | +17) :: | |
| 533 | + | |
| 534 | + // Map skb->priority to L2 prio for Eth1.100, one to one | |
| 535 | + $ ip link set eth1.100 type vlan \ | |
| 536 | + egress 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7 | |
| 537 | + | |
| 538 | +18) :: | |
| 539 | + | |
| 540 | + // Check egress map for vlan 100 | |
| 541 | + $ cat /proc/net/vlan/eth1.100 | |
| 542 | + [...] | |
| 543 | + INGRESS priority mappings: 0:0 1:0 2:0 3:0 4:0 5:0 6:0 7:0 | |
| 544 | + EGRESS priority mappings: 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7 | |
| 545 | + | |
| 546 | +19) :: | |
| 547 | + | |
| 548 | + // Run appropriate tools with socket option "SO_PRIORITY" to 3 | |
| 549 | + // for class A and to 2 for class B. For both interfaces | |
| 550 | + ./tsn_talker -d 18:03:73:66:87:42 -i eth0.100 -p2 -s 1500& | |
| 551 | + ./tsn_talker -d 18:03:73:66:87:42 -i eth0.100 -p3 -s 1500& | |
| 552 | + ./tsn_talker -d 20:cf:30:85:7d:fd -i eth1.100 -p2 -s 1500& | |
| 553 | + ./tsn_talker -d 20:cf:30:85:7d:fd -i eth1.100 -p3 -s 1500& | |
| 554 | + | |
| 555 | +20) :: | |
| 556 | + | |
| 557 | + // run your listener on workstation (should be in same vlan) | |
| 558 | + // (I took at https://www.spinics.net/lists/netdev/msg460869.html) | |
| 559 | + ./tsn_listener -d 18:03:73:66:87:42 -i enp5s0 -s 1500 | |
| 560 | + Receiving data rate: 39012 kbps | |
| 561 | + Receiving data rate: 39012 kbps | |
| 562 | + Receiving data rate: 39012 kbps | |
| 563 | + Receiving data rate: 39012 kbps | |
| 564 | + Receiving data rate: 39012 kbps | |
| 565 | + Receiving data rate: 39012 kbps | |
| 566 | + Receiving data rate: 39012 kbps | |
| 567 | + Receiving data rate: 39012 kbps | |
| 568 | + Receiving data rate: 39012 kbps | |
| 569 | + Receiving data rate: 39012 kbps | |
| 570 | + Receiving data rate: 39012 kbps | |
| 571 | + Receiving data rate: 39012 kbps | |
| 572 | + Receiving data rate: 39000 kbps | |
| 573 | + | |
| 574 | +21) :: | |
| 575 | + | |
| 576 | + // Restore default configuration if needed | |
| 577 | + $ ip link del eth1.100 | |
| 578 | + $ ip link del eth0.100 | |
| 579 | + $ tc qdisc del dev eth1 root | |
| 580 | + net eth1: Prev FIFO2 is shaped | |
| 581 | + net eth1: set FIFO3 bw = 0 | |
| 582 | + net eth1: set FIFO2 bw = 0 | |
| 583 | + $ tc qdisc del dev eth0 root | |
| 584 | + net eth0: Prev FIFO2 is shaped | |
| 585 | + net eth0: set FIFO3 bw = 0 | |
| 586 | + net eth0: set FIFO2 bw = 0 | |
| 587 | + $ ethtool -L eth0 rx 1 tx 1 | |
| @@ -1,541 +0,0 @@ | ||
| 1 | −* Texas Instruments CPSW ethernet driver | |
| 2 | − | |
| 3 | −Multiqueue & CBS & MQPRIO | |
| 4 | −===================================================================== | |
| 5 | −===================================================================== | |
| 6 | − | |
| 7 | −The cpsw has 3 CBS shapers for each external ports. This document | |
| 8 | −describes MQPRIO and CBS Qdisc offload configuration for cpsw driver | |
| 9 | −based on examples. It potentially can be used in audio video bridging | |
| 10 | −(AVB) and time sensitive networking (TSN). | |
| 11 | − | |
| 12 | −The following examples were tested on AM572x EVM and BBB boards. | |
| 13 | − | |
| 14 | −Test setup | |
| 15 | −========== | |
| 16 | − | |
| 17 | −Under consideration two examples with AM572x EVM running cpsw driver | |
| 18 | −in dual_emac mode. | |
| 19 | − | |
| 20 | −Several prerequisites: | |
| 21 | −- TX queues must be rated starting from txq0 that has highest priority | |
| 22 | −- Traffic classes are used starting from 0, that has highest priority | |
| 23 | −- CBS shapers should be used with rated queues | |
| 24 | −- The bandwidth for CBS shapers has to be set a little bit more then | |
| 25 | − potential incoming rate, thus, rate of all incoming tx queues has | |
| 26 | − to be a little less | |
| 27 | −- Real rates can differ, due to discreetness | |
| 28 | −- Map skb-priority to txq is not enough, also skb-priority to l2 prio | |
| 29 | − map has to be created with ip or vconfig tool | |
| 30 | −- Any l2/socket prio (0 - 7) for classes can be used, but for | |
| 31 | − simplicity default values are used: 3 and 2 | |
| 32 | −- only 2 classes tested: A and B, but checked and can work with more, | |
| 33 | − maximum allowed 4, but only for 3 rate can be set. | |
| 34 | − | |
| 35 | −Test setup for examples | |
| 36 | −======================= | |
| 37 | − +-------------------------------+ | |
| 38 | − |--+ | | |
| 39 | − | | Workstation0 | | |
| 40 | − |E | MAC 18:03:73:66:87:42 | | |
| 41 | −+-----------------------------+ +--|t | | | |
| 42 | −| | 1 | E | | |h |./tsn_listener -d \ | | |
| 43 | −| Target board: | 0 | t |--+ |0 | 18:03:73:66:87:42 -i eth0 \| | |
| 44 | −| AM572x EVM | 0 | h | | | -s 1500 | | |
| 45 | −| | 0 | 0 | |--+ | | |
| 46 | −| Only 2 classes: |Mb +---| +-------------------------------+ | |
| 47 | −| class A, class B | | | |
| 48 | −| | +---| +-------------------------------+ | |
| 49 | −| | 1 | E | |--+ | | |
| 50 | −| | 0 | t | | | Workstation1 | | |
| 51 | −| | 0 | h |--+ |E | MAC 20:cf:30:85:7d:fd | | |
| 52 | −| |Mb | 1 | +--|t | | | |
| 53 | −+-----------------------------+ |h |./tsn_listener -d \ | | |
| 54 | − |0 | 20:cf:30:85:7d:fd -i eth0 \| | |
| 55 | − | | -s 1500 | | |
| 56 | − |--+ | | |
| 57 | − +-------------------------------+ | |
| 58 | − | |
| 59 | −********************************************************************* | |
| 60 | −********************************************************************* | |
| 61 | −********************************************************************* | |
| 62 | −Example 1: One port tx AVB configuration scheme for target board | |
| 63 | −---------------------------------------------------------------------- | |
| 64 | −(prints and scheme for AM572x evm, applicable for single port boards) | |
| 65 | − | |
| 66 | −tc - traffic class | |
| 67 | −txq - transmit queue | |
| 68 | −p - priority | |
| 69 | −f - fifo (cpsw fifo) | |
| 70 | −S - shaper configured | |
| 71 | − | |
| 72 | −+------------------------------------------------------------------+ u | |
| 73 | −| +---------------+ +---------------+ +------+ +------+ | s | |
| 74 | −| | | | | | | | | | e | |
| 75 | −| | App 1 | | App 2 | | Apps | | Apps | | r | |
| 76 | −| | Class A | | Class B | | Rest | | Rest | | | |
| 77 | −| | Eth0 | | Eth0 | | Eth0 | | Eth1 | | s | |
| 78 | −| | VLAN100 | | VLAN100 | | | | | | | | p | |
| 79 | −| | 40 Mb/s | | 20 Mb/s | | | | | | | | a | |
| 80 | −| | SO_PRIORITY=3 | | SO_PRIORITY=2 | | | | | | | | c | |
| 81 | −| | | | | | | | | | | | | | e | |
| 82 | −| +---|-----------+ +---|-----------+ +---|--+ +---|--+ | | |
| 83 | −+-----|------------------|------------------|--------|-------------+ | |
| 84 | − +-+ +------------+ | | | |
| 85 | − | | +-----------------+ +--+ | |
| 86 | − | | | | | |
| 87 | −+---|-------|-------------|-----------------------|----------------+ | |
| 88 | −| +----+ +----+ +----+ +----+ +----+ | | |
| 89 | −| | p3 | | p2 | | p1 | | p0 | | p0 | | k | |
| 90 | −| \ / \ / \ / \ / \ / | e | |
| 91 | −| \ / \ / \ / \ / \ / | r | |
| 92 | −| \/ \/ \/ \/ \/ | n | |
| 93 | −| | | | | | e | |
| 94 | −| | | +-----+ | | l | |
| 95 | −| | | | | | | |
| 96 | −| +----+ +----+ +----+ +----+ | s | |
| 97 | −| |tc0 | |tc1 | |tc2 | |tc0 | | p | |
| 98 | −| \ / \ / \ / \ / | a | |
| 99 | −| \ / \ / \ / \ / | c | |
| 100 | −| \/ \/ \/ \/ | e | |
| 101 | −| | | +-----+ | | | |
| 102 | −| | | | | | | | |
| 103 | −| | | | | | | | |
| 104 | −| | | | | | | | |
| 105 | −| +----+ +----+ +----+ +----+ +----+ | | |
| 106 | −| |txq0| |txq1| |txq2| |txq3| |txq4| | | |
| 107 | −| \ / \ / \ / \ / \ / | | |
| 108 | −| \ / \ / \ / \ / \ / | | |
| 109 | −| \/ \/ \/ \/ \/ | | |
| 110 | −| +-|------|------|------|--+ +--|--------------+ | | |
| 111 | −| | | | | | | Eth0.100 | | Eth1 | | | |
| 112 | −+---|------|------|------|------------------------|----------------+ | |
| 113 | − | | | | | | |
| 114 | − p p p p | | |
| 115 | − 3 2 0-1, 4-7 <- L2 priority | | |
| 116 | − | | | | | | |
| 117 | − | | | | | | |
| 118 | −+---|------|------|------|------------------------|----------------+ | |
| 119 | −| | | | | |----------+ | | |
| 120 | −| +----+ +----+ +----+ +----+ +----+ | | |
| 121 | −| |dma7| |dma6| |dma5| |dma4| |dma3| | | |
| 122 | −| \ / \ / \ / \ / \ / | c | |
| 123 | −| \S / \S / \ / \ / \ / | p | |
| 124 | −| \/ \/ \/ \/ \/ | s | |
| 125 | −| | | | +----- | | w | |
| 126 | −| | | | | | | | |
| 127 | −| | | | | | | d | |
| 128 | −| +----+ +----+ +----+p p+----+ | r | |
| 129 | −| | | | | | |o o| | | i | |
| 130 | −| | f3 | | f2 | | f0 |r r| f0 | | v | |
| 131 | −| |tc0 | |tc1 | |tc2 |t t|tc0 | | e | |
| 132 | −| \CBS / \CBS / \CBS /1 2\CBS / | r | |
| 133 | −| \S / \S / \ / \ / | | |
| 134 | −| \/ \/ \/ \/ | | |
| 135 | −+------------------------------------------------------------------+ | |
| 136 | −========================================Eth==========================> | |
| 137 | − | |
| 138 | −1) | |
| 139 | −// Add 4 tx queues, for interface Eth0, and 1 tx queue for Eth1 | |
| 140 | −$ ethtool -L eth0 rx 1 tx 5 | |
| 141 | −rx unmodified, ignoring | |
| 142 | − | |
| 143 | −2) | |
| 144 | −// Check if num of queues is set correctly: | |
| 145 | −$ ethtool -l eth0 | |
| 146 | −Channel parameters for eth0: | |
| 147 | −Pre-set maximums: | |
| 148 | −RX: 8 | |
| 149 | −TX: 8 | |
| 150 | −Other: 0 | |
| 151 | −Combined: 0 | |
| 152 | −Current hardware settings: | |
| 153 | −RX: 1 | |
| 154 | −TX: 5 | |
| 155 | −Other: 0 | |
| 156 | −Combined: 0 | |
| 157 | − | |
| 158 | −3) | |
| 159 | −// TX queues must be rated starting from 0, so set bws for tx0 and tx1 | |
| 160 | −// Set rates 40 and 20 Mb/s appropriately. | |
| 161 | −// Pay attention, real speed can differ a bit due to discreetness. | |
| 162 | −// Leave last 2 tx queues not rated. | |
| 163 | −$ echo 40 > /sys/class/net/eth0/queues/tx-0/tx_maxrate | |
| 164 | −$ echo 20 > /sys/class/net/eth0/queues/tx-1/tx_maxrate | |
| 165 | − | |
| 166 | −4) | |
| 167 | −// Check maximum rate of tx (cpdma) queues: | |
| 168 | −$ cat /sys/class/net/eth0/queues/tx-*/tx_maxrate | |
| 169 | −40 | |
| 170 | −20 | |
| 171 | −0 | |
| 172 | −0 | |
| 173 | −0 | |
| 174 | − | |
| 175 | −5) | |
| 176 | −// Map skb->priority to traffic class: | |
| 177 | −// 3pri -> tc0, 2pri -> tc1, (0,1,4-7)pri -> tc2 | |
| 178 | −// Map traffic class to transmit queue: | |
| 179 | −// tc0 -> txq0, tc1 -> txq1, tc2 -> (txq2, txq3) | |
| 180 | −$ tc qdisc replace dev eth0 handle 100: parent root mqprio num_tc 3 \ | |
| 181 | −map 2 2 1 0 2 2 2 2 2 2 2 2 2 2 2 2 queues 1@0 1@1 2@2 hw 1 | |
| 182 | − | |
| 183 | −5a) | |
| 184 | −// As two interface sharing same set of tx queues, assign all traffic | |
| 185 | −// coming to interface Eth1 to separate queue in order to not mix it | |
| 186 | −// with traffic from interface Eth0, so use separate txq to send | |
| 187 | −// packets to Eth1, so all prio -> tc0 and tc0 -> txq4 | |
| 188 | −// Here hw 0, so here still default configuration for eth1 in hw | |
| 189 | −$ tc qdisc replace dev eth1 handle 100: parent root mqprio num_tc 1 \ | |
| 190 | −map 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 queues 1@4 hw 0 | |
| 191 | − | |
| 192 | −6) | |
| 193 | −// Check classes settings | |
| 194 | −$ tc -g class show dev eth0 | |
| 195 | −+---(100:ffe2) mqprio | |
| 196 | −| +---(100:3) mqprio | |
| 197 | −| +---(100:4) mqprio | |
| 198 | −| | |
| 199 | −+---(100:ffe1) mqprio | |
| 200 | −| +---(100:2) mqprio | |
| 201 | −| | |
| 202 | −+---(100:ffe0) mqprio | |
| 203 | − +---(100:1) mqprio | |
| 204 | − | |
| 205 | −$ tc -g class show dev eth1 | |
| 206 | −+---(100:ffe0) mqprio | |
| 207 | − +---(100:5) mqprio | |
| 208 | − | |
| 209 | −7) | |
| 210 | −// Set rate for class A - 41 Mbit (tc0, txq0) using CBS Qdisc | |
| 211 | −// Set it +1 Mb for reserve (important!) | |
| 212 | −// here only idle slope is important, others arg are ignored | |
| 213 | −// Pay attention, real speed can differ a bit due to discreetness | |
| 214 | −$ tc qdisc add dev eth0 parent 100:1 cbs locredit -1438 \ | |
| 215 | −hicredit 62 sendslope -959000 idleslope 41000 offload 1 | |
| 216 | −net eth0: set FIFO3 bw = 50 | |
| 217 | − | |
| 218 | −8) | |
| 219 | −// Set rate for class B - 21 Mbit (tc1, txq1) using CBS Qdisc: | |
| 220 | −// Set it +1 Mb for reserve (important!) | |
| 221 | −$ tc qdisc add dev eth0 parent 100:2 cbs locredit -1468 \ | |
| 222 | −hicredit 65 sendslope -979000 idleslope 21000 offload 1 | |
| 223 | −net eth0: set FIFO2 bw = 30 | |
| 224 | − | |
| 225 | −9) | |
| 226 | −// Create vlan 100 to map sk->priority to vlan qos | |
| 227 | −$ ip link add link eth0 name eth0.100 type vlan id 100 | |
| 228 | −8021q: 802.1Q VLAN Support v1.8 | |
| 229 | −8021q: adding VLAN 0 to HW filter on device eth0 | |
| 230 | −8021q: adding VLAN 0 to HW filter on device eth1 | |
| 231 | −net eth0: Adding vlanid 100 to vlan filter | |
| 232 | − | |
| 233 | −10) | |
| 234 | −// Map skb->priority to L2 prio, 1 to 1 | |
| 235 | −$ ip link set eth0.100 type vlan \ | |
| 236 | −egress 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7 | |
| 237 | − | |
| 238 | −11) | |
| 239 | −// Check egress map for vlan 100 | |
| 240 | −$ cat /proc/net/vlan/eth0.100 | |
| 241 | −[...] | |
| 242 | −INGRESS priority mappings: 0:0 1:0 2:0 3:0 4:0 5:0 6:0 7:0 | |
| 243 | −EGRESS priority mappings: 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7 | |
| 244 | − | |
| 245 | −12) | |
| 246 | −// Run your appropriate tools with socket option "SO_PRIORITY" | |
| 247 | −// to 3 for class A and/or to 2 for class B | |
| 248 | −// (I took at https://www.spinics.net/lists/netdev/msg460869.html) | |
| 249 | −./tsn_talker -d 18:03:73:66:87:42 -i eth0.100 -p3 -s 1500& | |
| 250 | −./tsn_talker -d 18:03:73:66:87:42 -i eth0.100 -p2 -s 1500& | |
| 251 | − | |
| 252 | −13) | |
| 253 | −// run your listener on workstation (should be in same vlan) | |
| 254 | −// (I took at https://www.spinics.net/lists/netdev/msg460869.html) | |
| 255 | −./tsn_listener -d 18:03:73:66:87:42 -i enp5s0 -s 1500 | |
| 256 | −Receiving data rate: 39012 kbps | |
| 257 | −Receiving data rate: 39012 kbps | |
| 258 | −Receiving data rate: 39012 kbps | |
| 259 | −Receiving data rate: 39012 kbps | |
| 260 | −Receiving data rate: 39012 kbps | |
| 261 | −Receiving data rate: 39012 kbps | |
| 262 | −Receiving data rate: 39012 kbps | |
| 263 | −Receiving data rate: 39012 kbps | |
| 264 | −Receiving data rate: 39012 kbps | |
| 265 | −Receiving data rate: 39012 kbps | |
| 266 | −Receiving data rate: 39012 kbps | |
| 267 | −Receiving data rate: 39012 kbps | |
| 268 | −Receiving data rate: 39000 kbps | |
| 269 | − | |
| 270 | −14) | |
| 271 | −// Restore default configuration if needed | |
| 272 | −$ ip link del eth0.100 | |
| 273 | −$ tc qdisc del dev eth1 root | |
| 274 | −$ tc qdisc del dev eth0 root | |
| 275 | −net eth0: Prev FIFO2 is shaped | |
| 276 | −net eth0: set FIFO3 bw = 0 | |
| 277 | −net eth0: set FIFO2 bw = 0 | |
| 278 | −$ ethtool -L eth0 rx 1 tx 1 | |
| 279 | − | |
| 280 | −********************************************************************* | |
| 281 | −********************************************************************* | |
| 282 | −********************************************************************* | |
| 283 | −Example 2: Two port tx AVB configuration scheme for target board | |
| 284 | −---------------------------------------------------------------------- | |
| 285 | −(prints and scheme for AM572x evm, for dual emac boards only) | |
| 286 | − | |
| 287 | −+------------------------------------------------------------------+ u | |
| 288 | −| +----------+ +----------+ +------+ +----------+ +----------+ | s | |
| 289 | −| | | | | | | | | | | | e | |
| 290 | −| | App 1 | | App 2 | | Apps | | App 3 | | App 4 | | r | |
| 291 | −| | Class A | | Class B | | Rest | | Class B | | Class A | | | |
| 292 | −| | Eth0 | | Eth0 | | | | | Eth1 | | Eth1 | | s | |
| 293 | −| | VLAN100 | | VLAN100 | | | | | VLAN100 | | VLAN100 | | p | |
| 294 | −| | 40 Mb/s | | 20 Mb/s | | | | | 10 Mb/s | | 30 Mb/s | | a | |
| 295 | −| | SO_PRI=3 | | SO_PRI=2 | | | | | SO_PRI=3 | | SO_PRI=2 | | c | |
| 296 | −| | | | | | | | | | | | | | | | | e | |
| 297 | −| +---|------+ +---|------+ +---|--+ +---|------+ +---|------+ | | |
| 298 | −+-----|-------------|-------------|---------|-------------|--------+ | |
| 299 | − +-+ +-------+ | +----------+ +----+ | |
| 300 | − | | +-------+------+ | | | |
| 301 | − | | | | | | | |
| 302 | −+---|-------|-------------|--------------|-------------|-------|---+ | |
| 303 | −| +----+ +----+ +----+ +----+ +----+ +----+ +----+ +----+ | | |
| 304 | −| | p3 | | p2 | | p1 | | p0 | | p0 | | p1 | | p2 | | p3 | | k | |
| 305 | −| \ / \ / \ / \ / \ / \ / \ / \ / | e | |
| 306 | −| \ / \ / \ / \ / \ / \ / \ / \ / | r | |
| 307 | −| \/ \/ \/ \/ \/ \/ \/ \/ | n | |
| 308 | −| | | | | | | | e | |
| 309 | −| | | +----+ +----+ | | | l | |
| 310 | −| | | | | | | | | |
| 311 | −| +----+ +----+ +----+ +----+ +----+ +----+ | s | |
| 312 | −| |tc0 | |tc1 | |tc2 | |tc2 | |tc1 | |tc0 | | p | |
| 313 | −| \ / \ / \ / \ / \ / \ / | a | |
| 314 | −| \ / \ / \ / \ / \ / \ / | c | |
| 315 | −| \/ \/ \/ \/ \/ \/ | e | |
| 316 | −| | | +-----+ +-----+ | | | | |
| 317 | −| | | | | | | | | | | |
| 318 | −| | | | | | | | | | | |
| 319 | −| | | | | E E | | | | | | |
| 320 | −| +----+ +----+ +----+ +----+ t t +----+ +----+ +----+ +----+ | | |
| 321 | −| |txq0| |txq1| |txq4| |txq5| h h |txq6| |txq7| |txq3| |txq2| | | |
| 322 | −| \ / \ / \ / \ / 0 1 \ / \ / \ / \ / | | |
| 323 | −| \ / \ / \ / \ / . . \ / \ / \ / \ / | | |
| 324 | −| \/ \/ \/ \/ 1 1 \/ \/ \/ \/ | | |
| 325 | −| +-|------|------|------|--+ 0 0 +-|------|------|------|--+ | | |
| 326 | −| | | | | | | 0 0 | | | | | | | | |
| 327 | −+---|------|------|------|---------------|------|------|------|----+ | |
| 328 | − | | | | | | | | | |
| 329 | − p p p p p p p p | |
| 330 | − 3 2 0-1, 4-7 <-L2 pri-> 0-1, 4-7 2 3 | |
| 331 | − | | | | | | | | | |
| 332 | − | | | | | | | | | |
| 333 | −+---|------|------|------|---------------|------|------|------|----+ | |
| 334 | −| | | | | | | | | | | |
| 335 | −| +----+ +----+ +----+ +----+ +----+ +----+ +----+ +----+ | | |
| 336 | −| |dma7| |dma6| |dma3| |dma2| |dma1| |dma0| |dma4| |dma5| | | |
| 337 | −| \ / \ / \ / \ / \ / \ / \ / \ / | c | |
| 338 | −| \S / \S / \ / \ / \ / \ / \S / \S / | p | |
| 339 | −| \/ \/ \/ \/ \/ \/ \/ \/ | s | |
| 340 | −| | | | +----- | | | | | w | |
| 341 | −| | | | | +----+ | | | | | |
| 342 | −| | | | | | | | | | d | |
| 343 | −| +----+ +----+ +----+p p+----+ +----+ +----+ | r | |
| 344 | −| | | | | | |o o| | | | | | | i | |
| 345 | −| | f3 | | f2 | | f0 |r CPSW r| f3 | | f2 | | f0 | | v | |
| 346 | −| |tc0 | |tc1 | |tc2 |t t|tc0 | |tc1 | |tc2 | | e | |
| 347 | −| \CBS / \CBS / \CBS /1 2\CBS / \CBS / \CBS / | r | |
| 348 | −| \S / \S / \ / \S / \S / \ / | | |
| 349 | −| \/ \/ \/ \/ \/ \/ | | |
| 350 | −+------------------------------------------------------------------+ | |
| 351 | −========================================Eth==========================> | |
| 352 | − | |
| 353 | −1) | |
| 354 | −// Add 8 tx queues, for interface Eth0, but they are common, so are accessed | |
| 355 | −// by two interfaces Eth0 and Eth1. | |
| 356 | −$ ethtool -L eth1 rx 1 tx 8 | |
| 357 | −rx unmodified, ignoring | |
| 358 | − | |
| 359 | −2) | |
| 360 | −// Check if num of queues is set correctly: | |
| 361 | −$ ethtool -l eth0 | |
| 362 | −Channel parameters for eth0: | |
| 363 | −Pre-set maximums: | |
| 364 | −RX: 8 | |
| 365 | −TX: 8 | |
| 366 | −Other: 0 | |
| 367 | −Combined: 0 | |
| 368 | −Current hardware settings: | |
| 369 | −RX: 1 | |
| 370 | −TX: 8 | |
| 371 | −Other: 0 | |
| 372 | −Combined: 0 | |
| 373 | − | |
| 374 | −3) | |
| 375 | −// TX queues must be rated starting from 0, so set bws for tx0 and tx1 for Eth0 | |
| 376 | −// and for tx2 and tx3 for Eth1. That is, rates 40 and 20 Mb/s appropriately | |
| 377 | −// for Eth0 and 30 and 10 Mb/s for Eth1. | |
| 378 | −// Real speed can differ a bit due to discreetness | |
| 379 | −// Leave last 4 tx queues as not rated | |
| 380 | −$ echo 40 > /sys/class/net/eth0/queues/tx-0/tx_maxrate | |
| 381 | −$ echo 20 > /sys/class/net/eth0/queues/tx-1/tx_maxrate | |
| 382 | −$ echo 30 > /sys/class/net/eth1/queues/tx-2/tx_maxrate | |
| 383 | −$ echo 10 > /sys/class/net/eth1/queues/tx-3/tx_maxrate | |
| 384 | − | |
| 385 | −4) | |
| 386 | −// Check maximum rate of tx (cpdma) queues: | |
| 387 | −$ cat /sys/class/net/eth0/queues/tx-*/tx_maxrate | |
| 388 | −40 | |
| 389 | −20 | |
| 390 | −30 | |
| 391 | −10 | |
| 392 | −0 | |
| 393 | −0 | |
| 394 | −0 | |
| 395 | −0 | |
| 396 | − | |
| 397 | −5) | |
| 398 | −// Map skb->priority to traffic class for Eth0: | |
| 399 | −// 3pri -> tc0, 2pri -> tc1, (0,1,4-7)pri -> tc2 | |
| 400 | −// Map traffic class to transmit queue: | |
| 401 | −// tc0 -> txq0, tc1 -> txq1, tc2 -> (txq4, txq5) | |
| 402 | −$ tc qdisc replace dev eth0 handle 100: parent root mqprio num_tc 3 \ | |
| 403 | −map 2 2 1 0 2 2 2 2 2 2 2 2 2 2 2 2 queues 1@0 1@1 2@4 hw 1 | |
| 404 | − | |
| 405 | −6) | |
| 406 | −// Check classes settings | |
| 407 | −$ tc -g class show dev eth0 | |
| 408 | −+---(100:ffe2) mqprio | |
| 409 | −| +---(100:5) mqprio | |
| 410 | −| +---(100:6) mqprio | |
| 411 | −| | |
| 412 | −+---(100:ffe1) mqprio | |
| 413 | −| +---(100:2) mqprio | |
| 414 | −| | |
| 415 | −+---(100:ffe0) mqprio | |
| 416 | − +---(100:1) mqprio | |
| 417 | − | |
| 418 | −7) | |
| 419 | −// Set rate for class A - 41 Mbit (tc0, txq0) using CBS Qdisc for Eth0 | |
| 420 | −// here only idle slope is important, others ignored | |
| 421 | −// Real speed can differ a bit due to discreetness | |
| 422 | −$ tc qdisc add dev eth0 parent 100:1 cbs locredit -1470 \ | |
| 423 | −hicredit 62 sendslope -959000 idleslope 41000 offload 1 | |
| 424 | −net eth0: set FIFO3 bw = 50 | |
| 425 | − | |
| 426 | −8) | |
| 427 | −// Set rate for class B - 21 Mbit (tc1, txq1) using CBS Qdisc for Eth0 | |
| 428 | −$ tc qdisc add dev eth0 parent 100:2 cbs locredit -1470 \ | |
| 429 | −hicredit 65 sendslope -979000 idleslope 21000 offload 1 | |
| 430 | −net eth0: set FIFO2 bw = 30 | |
| 431 | − | |
| 432 | −9) | |
| 433 | −// Create vlan 100 to map sk->priority to vlan qos for Eth0 | |
| 434 | −$ ip link add link eth0 name eth0.100 type vlan id 100 | |
| 435 | −net eth0: Adding vlanid 100 to vlan filter | |
| 436 | − | |
| 437 | −10) | |
| 438 | −// Map skb->priority to L2 prio for Eth0.100, one to one | |
| 439 | −$ ip link set eth0.100 type vlan \ | |
| 440 | −egress 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7 | |
| 441 | − | |
| 442 | −11) | |
| 443 | −// Check egress map for vlan 100 | |
| 444 | −$ cat /proc/net/vlan/eth0.100 | |
| 445 | −[...] | |
| 446 | −INGRESS priority mappings: 0:0 1:0 2:0 3:0 4:0 5:0 6:0 7:0 | |
| 447 | −EGRESS priority mappings: 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7 | |
| 448 | − | |
| 449 | −12) | |
| 450 | −// Map skb->priority to traffic class for Eth1: | |
| 451 | −// 3pri -> tc0, 2pri -> tc1, (0,1,4-7)pri -> tc2 | |
| 452 | −// Map traffic class to transmit queue: | |
| 453 | −// tc0 -> txq2, tc1 -> txq3, tc2 -> (txq6, txq7) | |
| 454 | −$ tc qdisc replace dev eth1 handle 100: parent root mqprio num_tc 3 \ | |
| 455 | −map 2 2 1 0 2 2 2 2 2 2 2 2 2 2 2 2 queues 1@2 1@3 2@6 hw 1 | |
| 456 | − | |
| 457 | −13) | |
| 458 | −// Check classes settings | |
| 459 | −$ tc -g class show dev eth1 | |
| 460 | −+---(100:ffe2) mqprio | |
| 461 | −| +---(100:7) mqprio | |
| 462 | −| +---(100:8) mqprio | |
| 463 | −| | |
| 464 | −+---(100:ffe1) mqprio | |
| 465 | −| +---(100:4) mqprio | |
| 466 | −| | |
| 467 | −+---(100:ffe0) mqprio | |
| 468 | − +---(100:3) mqprio | |
| 469 | − | |
| 470 | −14) | |
| 471 | −// Set rate for class A - 31 Mbit (tc0, txq2) using CBS Qdisc for Eth1 | |
| 472 | −// here only idle slope is important, others ignored, but calculated | |
| 473 | −// for interface speed - 100Mb for eth1 port. | |
| 474 | −// Set it +1 Mb for reserve (important!) | |
| 475 | −$ tc qdisc add dev eth1 parent 100:3 cbs locredit -1035 \ | |
| 476 | −hicredit 465 sendslope -69000 idleslope 31000 offload 1 | |
| 477 | −net eth1: set FIFO3 bw = 31 | |
| 478 | − | |
| 479 | −15) | |
| 480 | −// Set rate for class B - 11 Mbit (tc1, txq3) using CBS Qdisc for Eth1 | |
| 481 | −// Set it +1 Mb for reserve (important!) | |
| 482 | −$ tc qdisc add dev eth1 parent 100:4 cbs locredit -1335 \ | |
| 483 | −hicredit 405 sendslope -89000 idleslope 11000 offload 1 | |
| 484 | −net eth1: set FIFO2 bw = 11 | |
| 485 | − | |
| 486 | −16) | |
| 487 | −// Create vlan 100 to map sk->priority to vlan qos for Eth1 | |
| 488 | −$ ip link add link eth1 name eth1.100 type vlan id 100 | |
| 489 | −net eth1: Adding vlanid 100 to vlan filter | |
| 490 | − | |
| 491 | −17) | |
| 492 | −// Map skb->priority to L2 prio for Eth1.100, one to one | |
| 493 | −$ ip link set eth1.100 type vlan \ | |
| 494 | −egress 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7 | |
| 495 | − | |
| 496 | −18) | |
| 497 | −// Check egress map for vlan 100 | |
| 498 | −$ cat /proc/net/vlan/eth1.100 | |
| 499 | −[...] | |
| 500 | −INGRESS priority mappings: 0:0 1:0 2:0 3:0 4:0 5:0 6:0 7:0 | |
| 501 | −EGRESS priority mappings: 0:0 1:1 2:2 3:3 4:4 5:5 6:6 7:7 | |
| 502 | − | |
| 503 | −19) | |
| 504 | −// Run appropriate tools with socket option "SO_PRIORITY" to 3 | |
| 505 | −// for class A and to 2 for class B. For both interfaces | |
| 506 | −./tsn_talker -d 18:03:73:66:87:42 -i eth0.100 -p2 -s 1500& | |
| 507 | −./tsn_talker -d 18:03:73:66:87:42 -i eth0.100 -p3 -s 1500& | |
| 508 | −./tsn_talker -d 20:cf:30:85:7d:fd -i eth1.100 -p2 -s 1500& | |
| 509 | −./tsn_talker -d 20:cf:30:85:7d:fd -i eth1.100 -p3 -s 1500& | |
| 510 | − | |
| 511 | −20) | |
| 512 | −// run your listener on workstation (should be in same vlan) | |
| 513 | −// (I took at https://www.spinics.net/lists/netdev/msg460869.html) | |
| 514 | −./tsn_listener -d 18:03:73:66:87:42 -i enp5s0 -s 1500 | |
| 515 | −Receiving data rate: 39012 kbps | |
| 516 | −Receiving data rate: 39012 kbps | |
| 517 | −Receiving data rate: 39012 kbps | |
| 518 | −Receiving data rate: 39012 kbps | |
| 519 | −Receiving data rate: 39012 kbps | |
| 520 | −Receiving data rate: 39012 kbps | |
| 521 | −Receiving data rate: 39012 kbps | |
| 522 | −Receiving data rate: 39012 kbps | |
| 523 | −Receiving data rate: 39012 kbps | |
| 524 | −Receiving data rate: 39012 kbps | |
| 525 | −Receiving data rate: 39012 kbps | |
| 526 | −Receiving data rate: 39012 kbps | |
| 527 | −Receiving data rate: 39000 kbps | |
| 528 | − | |
| 529 | −21) | |
| 530 | −// Restore default configuration if needed | |
| 531 | −$ ip link del eth1.100 | |
| 532 | −$ ip link del eth0.100 | |
| 533 | −$ tc qdisc del dev eth1 root | |
| 534 | −net eth1: Prev FIFO2 is shaped | |
| 535 | −net eth1: set FIFO3 bw = 0 | |
| 536 | −net eth1: set FIFO2 bw = 0 | |
| 537 | −$ tc qdisc del dev eth0 root | |
| 538 | −net eth0: Prev FIFO2 is shaped | |
| 539 | −net eth0: set FIFO3 bw = 0 | |
| 540 | −net eth0: set FIFO2 bw = 0 | |
| 541 | −$ ethtool -L eth0 rx 1 tx 1 | |
| @@ -1,30 +1,44 @@ | ||
| 1 | −* Texas Instruments CPSW switchdev based ethernet driver 2.0 | |
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +====================================================== | |
| 4 | +Texas Instruments CPSW switchdev based ethernet driver | |
| 5 | +====================================================== | |
| 6 | + | |
| 7 | +:Version: 2.0 | |
| 8 | + | |
| 9 | +Port renaming | |
| 10 | +============= | |
| 2 | 11 | |
| 3 | −- Port renaming | |
| 4 | 12 | On older udev versions renaming of ethX to swXpY will not be automatically |
| 5 | 13 | supported |
| 6 | −In order to rename via udev: | |
| 7 | −ip -d link show dev sw0p1 | grep switchid | |
| 8 | 14 | |
| 9 | −SUBSYSTEM=="net", ACTION=="add", ATTR{phys_switch_id}==<switchid>, \ | |
| 10 | − ATTR{phys_port_name}!="", NAME="sw0$attr{phys_port_name}" | |
| 15 | +In order to rename via udev:: | |
| 16 | + | |
| 17 | + ip -d link show dev sw0p1 | grep switchid | |
| 18 | + | |
| 19 | + SUBSYSTEM=="net", ACTION=="add", ATTR{phys_switch_id}==<switchid>, \ | |
| 20 | + ATTR{phys_port_name}!="", NAME="sw0$attr{phys_port_name}" | |
| 21 | + | |
| 11 | 22 | |
| 23 | +Dual mac mode | |
| 24 | +============= | |
| 12 | 25 | |
| 13 | −==================== | |
| 14 | −# Dual mac mode | |
| 15 | −==================== | |
| 16 | 26 | - The new (cpsw_new.c) driver is operating in dual-emac mode by default, thus |
| 17 | −working as 2 individual network interfaces. Main differences from legacy CPSW | |
| 18 | −driver are: | |
| 27 | + working as 2 individual network interfaces. Main differences from legacy CPSW | |
| 28 | + driver are: | |
| 29 | + | |
| 19 | 30 | - optimized promiscuous mode: The P0_UNI_FLOOD (both ports) is enabled in |
| 20 | −addition to ALLMULTI (current port) instead of ALE_BYPASS. | |
| 21 | −So, Ports in promiscuous mode will keep possibility of mcast and vlan filtering, | |
| 22 | −which is provides significant benefits when ports are joined to the same bridge, | |
| 23 | −but without enabling "switch" mode, or to different bridges. | |
| 31 | + addition to ALLMULTI (current port) instead of ALE_BYPASS. | |
| 32 | + So, Ports in promiscuous mode will keep possibility of mcast and vlan | |
| 33 | + filtering, which is provides significant benefits when ports are joined | |
| 34 | + to the same bridge, but without enabling "switch" mode, or to different | |
| 35 | + bridges. | |
| 24 | 36 | - learning disabled on ports as it make not too much sense for |
| 25 | 37 | segregated ports - no forwarding in HW. |
| 26 | 38 | - enabled basic support for devlink. |
| 27 | 39 | |
| 40 | + :: | |
| 41 | + | |
| 28 | 42 | devlink dev show |
| 29 | 43 | platform/48484000.switch |
| 30 | 44 | |
| @@ -38,22 +52,25 @@ but without enabling "switch" mode, or to different bridges. · 7 unmodified lines | ||
| 38 | 52 | cmode runtime value false |
| 39 | 53 | |
| 40 | 54 | Devlink configuration parameters |
| 41 | −==================== | |
| 55 | +================================ | |
| 56 | + | |
| 42 | 57 | See Documentation/networking/devlink/ti-cpsw-switch.rst |
| 43 | 58 | |
| 44 | −==================== | |
| 45 | −# Bridging in dual mac mode | |
| 46 | −==================== | |
| 59 | +Bridging in dual mac mode | |
| 60 | +========================= | |
| 61 | + | |
| 47 | 62 | The dual_mac mode requires two vids to be reserved for internal purposes, |
| 48 | 63 | which, by default, equal CPSW Port numbers. As result, bridge has to be |
| 49 | −configured in vlan unaware mode or default_pvid has to be adjusted. | |
| 64 | +configured in vlan unaware mode or default_pvid has to be adjusted:: | |
| 50 | 65 | |
| 51 | 66 | ip link add name br0 type bridge |
| 52 | 67 | ip link set dev br0 type bridge vlan_filtering 0 |
| 53 | 68 | echo 0 > /sys/class/net/br0/bridge/default_pvid |
| 54 | 69 | ip link set dev sw0p1 master br0 |
| 55 | 70 | ip link set dev sw0p2 master br0 |
| 56 | − - or - | |
| 71 | + | |
| 72 | +or:: | |
| 73 | + | |
| 57 | 74 | ip link add name br0 type bridge |
| 58 | 75 | ip link set dev br0 type bridge vlan_filtering 0 |
| 59 | 76 | echo 100 > /sys/class/net/br0/bridge/default_pvid |
| @@ -61,11 +78,12 @@ configured in vlan unaware mode or default_pvid has to be adjusted. · 1 unmodified line | ||
| 61 | 78 | ip link set dev sw0p1 master br0 |
| 62 | 79 | ip link set dev sw0p2 master br0 |
| 63 | 80 | |
| 64 | −==================== | |
| 65 | −# Enabling "switch" | |
| 66 | −==================== | |
| 81 | +Enabling "switch" | |
| 82 | +================= | |
| 83 | + | |
| 67 | 84 | The Switch mode can be enabled by configuring devlink driver parameter |
| 68 | −"switch_mode" to 1/true: | |
| 85 | +"switch_mode" to 1/true:: | |
| 86 | + | |
| 69 | 87 | devlink dev param set platform/48484000.switch \ |
| 70 | 88 | name switch_mode value 1 cmode runtime |
| 71 | 89 | |
| @@ -79,9 +97,11 @@ marking packets with offload_fwd_mark flag unless "ale_bypass=0" · 7 unmodified lines | ||
| 79 | 97 | |
| 80 | 98 | All configuration is implemented via switchdev API. |
| 81 | 99 | |
| 82 | −==================== | |
| 83 | −# Bridge setup | |
| 84 | −==================== | |
| 100 | +Bridge setup | |
| 101 | +============ | |
| 102 | + | |
| 103 | +:: | |
| 104 | + | |
| 85 | 105 | devlink dev param set platform/48484000.switch \ |
| 86 | 106 | name switch_mode value 1 cmode runtime |
| 87 | 107 | |
| @@ -91,56 +111,65 @@ All configuration is implemented via switchdev API. · 3 unmodified lines | ||
| 91 | 111 | ip link set dev sw0p2 up |
| 92 | 112 | ip link set dev sw0p1 master br0 |
| 93 | 113 | ip link set dev sw0p2 master br0 |
| 114 | + | |
| 94 | 115 | [*] bridge vlan add dev br0 vid 1 pvid untagged self |
| 95 | 116 | |
| 96 | −[*] if vlan_filtering=1. where default_pvid=1 | |
| 117 | + [*] if vlan_filtering=1. where default_pvid=1 | |
| 97 | 118 | |
| 98 | −================= | |
| 99 | −# On/off STP | |
| 100 | −================= | |
| 101 | −ip link set dev BRDEV type bridge stp_state 1/0 | |
| 119 | + Note. Steps [*] are mandatory. | |
| 120 | + | |
| 121 | + | |
| 122 | +On/off STP | |
| 123 | +========== | |
| 102 | 124 | |
| 103 | −Note. Steps [*] are mandatory. | |
| 125 | +:: | |
| 104 | 126 | |
| 105 | −==================== | |
| 106 | −# VLAN configuration | |
| 107 | −==================== | |
| 108 | −bridge vlan add dev br0 vid 1 pvid untagged self <---- add cpu port to VLAN 1 | |
| 127 | + ip link set dev BRDEV type bridge stp_state 1/0 | |
| 128 | + | |
| 129 | +VLAN configuration | |
| 130 | +================== | |
| 131 | + | |
| 132 | +:: | |
| 133 | + | |
| 134 | + bridge vlan add dev br0 vid 1 pvid untagged self <---- add cpu port to VLAN 1 | |
| 109 | 135 | |
| 110 | 136 | Note. This step is mandatory for bridge/default_pvid. |
| 111 | 137 | |
| 112 | −================= | |
| 113 | −# Add extra VLANs | |
| 114 | −================= | |
| 115 | − 1. untagged: | |
| 116 | − bridge vlan add dev sw0p1 vid 100 pvid untagged master | |
| 117 | − bridge vlan add dev sw0p2 vid 100 pvid untagged master | |
| 118 | − bridge vlan add dev br0 vid 100 pvid untagged self <---- Add cpu port to VLAN100 | |
| 138 | +Add extra VLANs | |
| 139 | +=============== | |
| 119 | 140 | |
| 120 | − 2. tagged: | |
| 121 | − bridge vlan add dev sw0p1 vid 100 master | |
| 122 | − bridge vlan add dev sw0p2 vid 100 master | |
| 123 | − bridge vlan add dev br0 vid 100 pvid tagged self <---- Add cpu port to VLAN100 | |
| 141 | + 1. untagged:: | |
| 142 | + | |
| 143 | + bridge vlan add dev sw0p1 vid 100 pvid untagged master | |
| 144 | + bridge vlan add dev sw0p2 vid 100 pvid untagged master | |
| 145 | + bridge vlan add dev br0 vid 100 pvid untagged self <---- Add cpu port to VLAN100 | |
| 146 | + | |
| 147 | + 2. tagged:: | |
| 148 | + | |
| 149 | + bridge vlan add dev sw0p1 vid 100 master | |
| 150 | + bridge vlan add dev sw0p2 vid 100 master | |
| 151 | + bridge vlan add dev br0 vid 100 pvid tagged self <---- Add cpu port to VLAN100 | |
| 124 | 152 | |
| 125 | −==== | |
| 126 | 153 | FDBs |
| 127 | −==== | |
| 154 | +---- | |
| 155 | + | |
| 128 | 156 | FDBs are automatically added on the appropriate switch port upon detection |
| 129 | 157 | |
| 130 | −Manually adding FDBs: | |
| 131 | −bridge fdb add aa:bb:cc:dd:ee:ff dev sw0p1 master vlan 100 | |
| 132 | −bridge fdb add aa:bb:cc:dd:ee:fe dev sw0p2 master <---- Add on all VLANs | |
| 158 | +Manually adding FDBs:: | |
| 159 | + | |
| 160 | + bridge fdb add aa:bb:cc:dd:ee:ff dev sw0p1 master vlan 100 | |
| 161 | + bridge fdb add aa:bb:cc:dd:ee:fe dev sw0p2 master <---- Add on all VLANs | |
| 133 | 162 | |
| 134 | −==== | |
| 135 | 163 | MDBs |
| 136 | −==== | |
| 164 | +---- | |
| 165 | + | |
| 137 | 166 | MDBs are automatically added on the appropriate switch port upon detection |
| 138 | 167 | |
| 139 | −Manually adding MDBs: | |
| 140 | −bridge mdb add dev br0 port sw0p1 grp 239.1.1.1 permanent vid 100 | |
| 141 | −bridge mdb add dev br0 port sw0p1 grp 239.1.1.1 permanent <---- Add on all VLANs | |
| 168 | +Manually adding MDBs:: | |
| 169 | + | |
| 170 | + bridge mdb add dev br0 port sw0p1 grp 239.1.1.1 permanent vid 100 | |
| 171 | + bridge mdb add dev br0 port sw0p1 grp 239.1.1.1 permanent <---- Add on all VLANs | |
| 142 | 172 | |
| 143 | −================== | |
| 144 | 173 | Multicast flooding |
| 145 | 174 | ================== |
| 146 | 175 | CPU port mcast_flooding is always on |
| @@ -148,9 +177,11 @@ CPU port mcast_flooding is always on · 1 unmodified line | ||
| 148 | 177 | Turning flooding on/off on swithch ports: |
| 149 | 178 | bridge link set dev sw0p1 mcast_flood on/off |
| 150 | 179 | |
| 151 | −================== | |
| 152 | 180 | Access and Trunk port |
| 153 | −================== | |
| 181 | +===================== | |
| 182 | + | |
| 183 | +:: | |
| 184 | + | |
| 154 | 185 | bridge vlan add dev sw0p1 vid 100 pvid untagged master |
| 155 | 186 | bridge vlan add dev sw0p2 vid 100 master |
| 156 | 187 | |
| @@ -158,52 +189,54 @@ Access and Trunk port · 1 unmodified line | ||
| 158 | 189 | bridge vlan add dev br0 vid 100 self |
| 159 | 190 | ip link add link br0 name br0.100 type vlan id 100 |
| 160 | 191 | |
| 161 | − Note. Setting PVID on Bridge device itself working only for | |
| 162 | − default VLAN (default_pvid). | |
| 192 | +Note. Setting PVID on Bridge device itself working only for | |
| 193 | +default VLAN (default_pvid). | |
| 194 | + | |
| 195 | +NFS | |
| 196 | +=== | |
| 163 | 197 | |
| 164 | −===================== | |
| 165 | − NFS | |
| 166 | −===================== | |
| 167 | 198 | The only way for NFS to work is by chrooting to a minimal environment when |
| 168 | 199 | switch configuration that will affect connectivity is needed. |
| 169 | 200 | Assuming you are booting NFS with eth1 interface(the script is hacky and |
| 170 | 201 | it's just there to prove NFS is doable). |
| 171 | 202 | |
| 172 | −setup.sh: | |
| 173 | −#!/bin/sh | |
| 174 | −mkdir proc | |
| 175 | −mount -t proc none /proc | |
| 176 | −ifconfig br0 > /dev/null | |
| 177 | −if [ $? -ne 0 ]; then | |
| 178 | − echo "Setting up bridge" | |
| 179 | − ip link add name br0 type bridge | |
| 180 | − ip link set dev br0 type bridge ageing_time 1000 | |
| 181 | − ip link set dev br0 type bridge vlan_filtering 1 | |
| 182 | − | |
| 183 | − ip link set eth1 down | |
| 184 | − ip link set eth1 name sw0p1 | |
| 185 | − ip link set dev sw0p1 up | |
| 186 | − ip link set dev sw0p2 up | |
| 187 | − ip link set dev sw0p2 master br0 | |
| 188 | − ip link set dev sw0p1 master br0 | |
| 189 | − bridge vlan add dev br0 vid 1 pvid untagged self | |
| 190 | − ifconfig sw0p1 0.0.0.0 | |
| 191 | − udhchc -i br0 | |
| 192 | −fi | |
| 193 | −umount /proc | |
| 194 | − | |
| 195 | −run_nfs.sh: | |
| 196 | −#!/bin/sh | |
| 197 | −mkdir /tmp/root/bin -p | |
| 198 | −mkdir /tmp/root/lib -p | |
| 199 | − | |
| 200 | −cp -r /lib/ /tmp/root/ | |
| 201 | −cp -r /bin/ /tmp/root/ | |
| 202 | −cp /sbin/ip /tmp/root/bin | |
| 203 | −cp /sbin/bridge /tmp/root/bin | |
| 204 | −cp /sbin/ifconfig /tmp/root/bin | |
| 205 | −cp /sbin/udhcpc /tmp/root/bin | |
| 206 | −cp /path/to/setup.sh /tmp/root/bin | |
| 207 | −chroot /tmp/root/ busybox sh /bin/setup.sh | |
| 208 | − | |
| 209 | −run ./run_nfs.sh | |
| 203 | +setup.sh:: | |
| 204 | + | |
| 205 | + #!/bin/sh | |
| 206 | + mkdir proc | |
| 207 | + mount -t proc none /proc | |
| 208 | + ifconfig br0 > /dev/null | |
| 209 | + if [ $? -ne 0 ]; then | |
| 210 | + echo "Setting up bridge" | |
| 211 | + ip link add name br0 type bridge | |
| 212 | + ip link set dev br0 type bridge ageing_time 1000 | |
| 213 | + ip link set dev br0 type bridge vlan_filtering 1 | |
| 214 | + | |
| 215 | + ip link set eth1 down | |
| 216 | + ip link set eth1 name sw0p1 | |
| 217 | + ip link set dev sw0p1 up | |
| 218 | + ip link set dev sw0p2 up | |
| 219 | + ip link set dev sw0p2 master br0 | |
| 220 | + ip link set dev sw0p1 master br0 | |
| 221 | + bridge vlan add dev br0 vid 1 pvid untagged self | |
| 222 | + ifconfig sw0p1 0.0.0.0 | |
| 223 | + udhchc -i br0 | |
| 224 | + fi | |
| 225 | + umount /proc | |
| 226 | + | |
| 227 | +run_nfs.sh::: | |
| 228 | + | |
| 229 | + #!/bin/sh | |
| 230 | + mkdir /tmp/root/bin -p | |
| 231 | + mkdir /tmp/root/lib -p | |
| 232 | + | |
| 233 | + cp -r /lib/ /tmp/root/ | |
| 234 | + cp -r /bin/ /tmp/root/ | |
| 235 | + cp /sbin/ip /tmp/root/bin | |
| 236 | + cp /sbin/bridge /tmp/root/bin | |
| 237 | + cp /sbin/ifconfig /tmp/root/bin | |
| 238 | + cp /sbin/udhcpc /tmp/root/bin | |
| 239 | + cp /path/to/setup.sh /tmp/root/bin | |
| 240 | + chroot /tmp/root/ busybox sh /bin/setup.sh | |
| 241 | + | |
| 242 | + run ./run_nfs.sh | |
| @@ -1,20 +1,33 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +===================== | |
| 4 | +TLAN driver for Linux | |
| 5 | +===================== | |
| 6 | + | |
| 7 | +:Version: 1.14a | |
| 8 | + | |
| 1 | 9 | (C) 1997-1998 Caldera, Inc. |
| 10 | + | |
| 2 | 11 | (C) 1998 James Banks |
| 12 | + | |
| 3 | 13 | (C) 1999-2001 Torben Mathiasen <tmm@image.dk, torben.mathiasen@compaq.com> |
| 4 | 14 | |
| 5 | 15 | For driver information/updates visit http://www.compaq.com |
| 6 | 16 | |
| 7 | 17 | |
| 8 | −TLAN driver for Linux, version 1.14a | |
| 9 | −README | |
| 10 | 18 | |
| 11 | 19 | |
| 12 | −I. Supported Devices. | |
| 20 | + | |
| 21 | +I. Supported Devices | |
| 22 | +==================== | |
| 13 | 23 | |
| 14 | 24 | Only PCI devices will work with this driver. |
| 15 | 25 | |
| 16 | 26 | Supported: |
| 27 | + | |
| 28 | + ========= ========= =========================================== | |
| 17 | 29 | Vendor ID Device ID Name |
| 30 | + ========= ========= =========================================== | |
| 18 | 31 | 0e11 ae32 Compaq Netelligent 10/100 TX PCI UTP |
| 19 | 32 | 0e11 ae34 Compaq Netelligent 10 T PCI UTP |
| 20 | 33 | 0e11 ae35 Compaq Integrated NetFlex 3/P |
| @@ -25,13 +38,14 @@ I. Supported Devices. · 4 unmodified lines | ||
| 25 | 38 | 0e11 b030 Compaq Netelligent 10/100 TX UTP |
| 26 | 39 | 0e11 f130 Compaq NetFlex 3/P |
| 27 | 40 | 0e11 f150 Compaq NetFlex 3/P |
| 28 | − 108d 0012 Olicom OC-2325 | |
| 41 | + 108d 0012 Olicom OC-2325 | |
| 29 | 42 | 108d 0013 Olicom OC-2183 |
| 30 | − 108d 0014 Olicom OC-2326 | |
| 43 | + 108d 0014 Olicom OC-2326 | |
| 44 | + ========= ========= =========================================== | |
| 31 | 45 | |
| 32 | 46 | |
| 33 | 47 | Caveats: |
| 34 | − | |
| 48 | + | |
| 35 | 49 | I am not sure if 100BaseTX daughterboards (for those cards which |
| 36 | 50 | support such things) will work. I haven't had any solid evidence |
| 37 | 51 | either way. |
| @@ -41,21 +55,25 @@ I. Supported Devices. · 3 unmodified lines | ||
| 41 | 55 | |
| 42 | 56 | The "Netelligent 10 T/2 PCI UTP/Coax" (b012) device is untested, |
| 43 | 57 | but I do not expect any problems. |
| 44 | − | |
| 45 | 58 | |
| 46 | −II. Driver Options | |
| 59 | + | |
| 60 | +II. Driver Options | |
| 61 | +================== | |
| 62 | + | |
| 47 | 63 | 1. You can append debug=x to the end of the insmod line to get |
| 48 | − debug messages, where x is a bit field where the bits mean | |
| 64 | + debug messages, where x is a bit field where the bits mean | |
| 49 | 65 | the following: |
| 50 | − | |
| 66 | + | |
| 67 | + ==== ===================================== | |
| 51 | 68 | 0x01 Turn on general debugging messages. |
| 52 | 69 | 0x02 Turn on receive debugging messages. |
| 53 | 70 | 0x04 Turn on transmit debugging messages. |
| 54 | 71 | 0x08 Turn on list debugging messages. |
| 72 | + ==== ===================================== | |
| 55 | 73 | |
| 56 | 74 | 2. You can append aui=1 to the end of the insmod line to cause |
| 57 | − the adapter to use the AUI interface instead of the 10 Base T | |
| 58 | − interface. This is also what to do if you want to use the BNC | |
| 75 | + the adapter to use the AUI interface instead of the 10 Base T | |
| 76 | + interface. This is also what to do if you want to use the BNC | |
| 59 | 77 | connector on a TLAN based device. (Setting this option on a |
| 60 | 78 | device that does not have an AUI/BNC connector will probably |
| 61 | 79 | cause it to not function correctly.) |
| @@ -70,41 +88,45 @@ II. Driver Options · 8 unmodified lines | ||
| 70 | 88 | |
| 71 | 89 | 5. You have to use speed=X duplex=Y together now. If you just |
| 72 | 90 | do "insmod tlan.o speed=100" the driver will do Auto-Neg. |
| 73 | − To force a 10Mbps Half-Duplex link do "insmod tlan.o speed=10 | |
| 91 | + To force a 10Mbps Half-Duplex link do "insmod tlan.o speed=10 | |
| 74 | 92 | duplex=1". |
| 75 | 93 | |
| 76 | 94 | 6. If the driver is built into the kernel, you can use the 3rd |
| 77 | 95 | and 4th parameters to set aui and debug respectively. For |
| 78 | − example: | |
| 96 | + example:: | |
| 79 | 97 | |
| 80 | − ether=0,0,0x1,0x7,eth0 | |
| 98 | + ether=0,0,0x1,0x7,eth0 | |
| 81 | 99 | |
| 82 | 100 | This sets aui to 0x1 and debug to 0x7, assuming eth0 is a |
| 83 | 101 | supported TLAN device. |
| 84 | 102 | |
| 85 | 103 | The bits in the third byte are assigned as follows: |
| 86 | 104 | |
| 87 | − 0x01 = aui | |
| 88 | − 0x02 = use half duplex | |
| 89 | − 0x04 = use full duplex | |
| 90 | − 0x08 = use 10BaseT | |
| 91 | − 0x10 = use 100BaseTx | |
| 105 | + ==== =============== | |
| 106 | + 0x01 aui | |
| 107 | + 0x02 use half duplex | |
| 108 | + 0x04 use full duplex | |
| 109 | + 0x08 use 10BaseT | |
| 110 | + 0x10 use 100BaseTx | |
| 111 | + ==== =============== | |
| 92 | 112 | |
| 93 | 113 | You also need to set both speed and duplex settings when forcing |
| 94 | − speeds with kernel-parameters. | |
| 114 | + speeds with kernel-parameters. | |
| 95 | 115 | ether=0,0,0x12,0,eth0 will force link to 100Mbps Half-Duplex. |
| 96 | 116 | |
| 97 | 117 | 7. If you have more than one tlan adapter in your system, you can |
| 98 | 118 | use the above options on a per adapter basis. To force a 100Mbit/HD |
| 99 | − link with your eth1 adapter use: | |
| 100 | − | |
| 101 | − insmod tlan speed=0,100 duplex=0,1 | |
| 119 | + link with your eth1 adapter use:: | |
| 120 | + | |
| 121 | + insmod tlan speed=0,100 duplex=0,1 | |
| 102 | 122 | |
| 103 | 123 | Now eth0 will use auto-neg and eth1 will be forced to 100Mbit/HD. |
| 104 | 124 | Note that the tlan driver supports a maximum of 8 adapters. |
| 105 | 125 | |
| 106 | 126 | |
| 107 | −III. Things to try if you have problems. | |
| 127 | +III. Things to try if you have problems | |
| 128 | +======================================= | |
| 129 | + | |
| 108 | 130 | 1. Make sure your card's PCI id is among those listed in |
| 109 | 131 | section I, above. |
| 110 | 132 | 2. Make sure routing is correct. |
| @@ -113,5 +135,6 @@ III. Things to try if you have problems. · 2 unmodified lines | ||
| 113 | 135 | |
| 114 | 136 | There is also a tlan mailing list which you can join by sending "subscribe tlan" |
| 115 | 137 | in the body of an email to majordomo@vuser.vu.union.edu. |
| 138 | + | |
| 116 | 139 | There is also a tlan website at http://www.compaq.com |
| 117 | 140 | |
| @@ -1,6 +1,8 @@ | ||
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 1 | 2 | |
| 2 | − The Spidernet Device Driver | |
| 3 | − =========================== | |
| 3 | +=========================== | |
| 4 | +The Spidernet Device Driver | |
| 5 | +=========================== | |
| 4 | 6 | |
| 5 | 7 | Written by Linas Vepstas <linas@austin.ibm.com> |
| 6 | 8 | |
| @@ -78,15 +80,15 @@ GDACTDPA, tail and head pointers. It will also summarize the contents · 71 unmodified lines | ||
| 78 | 80 | of the ring, starting at the tail pointer, and listing the status |
| 79 | 81 | of the descrs that follow. |
| 80 | 82 | |
| 81 | −A typical example of the output, for a nearly idle system, might be | |
| 83 | +A typical example of the output, for a nearly idle system, might be:: | |
| 82 | 84 | |
| 83 | −net eth1: Total number of descrs=256 | |
| 84 | −net eth1: Chain tail located at descr=20 | |
| 85 | −net eth1: Chain head is at 20 | |
| 86 | −net eth1: HW curr desc (GDACTDPA) is at 21 | |
| 87 | −net eth1: Have 1 descrs with stat=x40800101 | |
| 88 | −net eth1: HW next desc (GDACNEXTDA) is at 22 | |
| 89 | −net eth1: Last 255 descrs with stat=xa0800000 | |
| 85 | + net eth1: Total number of descrs=256 | |
| 86 | + net eth1: Chain tail located at descr=20 | |
| 87 | + net eth1: Chain head is at 20 | |
| 88 | + net eth1: HW curr desc (GDACTDPA) is at 21 | |
| 89 | + net eth1: Have 1 descrs with stat=x40800101 | |
| 90 | + net eth1: HW next desc (GDACNEXTDA) is at 22 | |
| 91 | + net eth1: Last 255 descrs with stat=xa0800000 | |
| 90 | 92 | |
| 91 | 93 | In the above, the hardware has filled in one descr, number 20. Both |
| 92 | 94 | head and tail are pointing at 20, because it has not yet been emptied. |
| @@ -101,11 +103,11 @@ The status x4... corresponds to "full" and status xa... corresponds · 8 unmodified lines | ||
| 101 | 103 | to "empty". The actual value printed is RXCOMST_A. |
| 102 | 104 | |
| 103 | 105 | In the device driver source code, a different set of names are |
| 104 | −used for these same concepts, so that | |
| 106 | +used for these same concepts, so that:: | |
| 105 | 107 | |
| 106 | −"empty" == SPIDER_NET_DESCR_CARDOWNED == 0xa | |
| 107 | −"full" == SPIDER_NET_DESCR_FRAME_END == 0x4 | |
| 108 | −"not in use" == SPIDER_NET_DESCR_NOT_IN_USE == 0xf | |
| 108 | + "empty" == SPIDER_NET_DESCR_CARDOWNED == 0xa | |
| 109 | + "full" == SPIDER_NET_DESCR_FRAME_END == 0x4 | |
| 110 | + "not in use" == SPIDER_NET_DESCR_NOT_IN_USE == 0xf | |
| 109 | 111 | |
| 110 | 112 | |
| 111 | 113 | The RX RAM full bug/feature |
| @@ -137,19 +139,19 @@ while the hardware is waiting for a different set of descrs to become · 25 unmodified lines | ||
| 137 | 139 | empty. |
| 138 | 140 | |
| 139 | 141 | A call to show_rx_chain() at this point indicates the nature of the |
| 140 | −problem. A typical print when the network is hung shows the following: | |
| 141 | − | |
| 142 | −net eth1: Spider RX RAM full, incoming packets might be discarded! | |
| 143 | −net eth1: Total number of descrs=256 | |
| 144 | −net eth1: Chain tail located at descr=255 | |
| 145 | −net eth1: Chain head is at 255 | |
| 146 | −net eth1: HW curr desc (GDACTDPA) is at 0 | |
| 147 | −net eth1: Have 1 descrs with stat=xa0800000 | |
| 148 | −net eth1: HW next desc (GDACNEXTDA) is at 1 | |
| 149 | −net eth1: Have 127 descrs with stat=x40800101 | |
| 150 | −net eth1: Have 1 descrs with stat=x40800001 | |
| 151 | −net eth1: Have 126 descrs with stat=x40800101 | |
| 152 | −net eth1: Last 1 descrs with stat=xa0800000 | |
| 142 | +problem. A typical print when the network is hung shows the following:: | |
| 143 | + | |
| 144 | + net eth1: Spider RX RAM full, incoming packets might be discarded! | |
| 145 | + net eth1: Total number of descrs=256 | |
| 146 | + net eth1: Chain tail located at descr=255 | |
| 147 | + net eth1: Chain head is at 255 | |
| 148 | + net eth1: HW curr desc (GDACTDPA) is at 0 | |
| 149 | + net eth1: Have 1 descrs with stat=xa0800000 | |
| 150 | + net eth1: HW next desc (GDACNEXTDA) is at 1 | |
| 151 | + net eth1: Have 127 descrs with stat=x40800101 | |
| 152 | + net eth1: Have 1 descrs with stat=x40800001 | |
| 153 | + net eth1: Have 126 descrs with stat=x40800101 | |
| 154 | + net eth1: Last 1 descrs with stat=xa0800000 | |
| 153 | 155 | |
| 154 | 156 | Both the tail and head pointers are pointing at descr 255, which is |
| 155 | 157 | marked xa... which is "empty". Thus, from the OS point of view, there |
| @@ -198,7 +200,3 @@ For large packets, this mechanism generates a relatively small number · 42 unmodified lines | ||
| 198 | 200 | of interrupts, about 1K/sec. For smaller packets, this will drop to zero |
| 199 | 201 | interrupts, as the hardware can empty the queue faster than the kernel |
| 200 | 202 | can fill it. |
| 201 | − | |
| 202 | − | |
| 203 | − ======= END OF DOCUMENT ======== | |
| 204 | − | |
| @@ -0,0 +1,27 @@ | ||
| 1 | +best_effort_vlan_filtering | |
| 2 | + [DEVICE, DRIVER-SPECIFIC] | |
| 3 | + Allow plain ETH_P_8021Q headers to be used as DSA tags. | |
| 4 | + Benefits: | |
| 5 | + - Can terminate untagged traffic over switch net | |
| 6 | + devices even when enslaved to a bridge with | |
| 7 | + vlan_filtering=1. | |
| 8 | + - Can terminate VLAN-tagged traffic over switch net | |
| 9 | + devices even when enslaved to a bridge with | |
| 10 | + vlan_filtering=1, with some constraints (no more than | |
| 11 | + 7 non-pvid VLANs per user port). | |
| 12 | + - Can do QoS based on VLAN PCP and VLAN membership | |
| 13 | + admission control for autonomously forwarded frames | |
| 14 | + (regardless of whether they can be terminated on the | |
| 15 | + CPU or not). | |
| 16 | + Drawbacks: | |
| 17 | + - User cannot use VLANs in range 1024-3071. If the | |
| 18 | + switch receives frames with such VIDs, it will | |
| 19 | + misinterpret them as DSA tags. | |
| 20 | + - Switch uses Shared VLAN Learning (FDB lookup uses | |
| 21 | + only DMAC as key). | |
| 22 | + - When VLANs span cross-chip topologies, the total | |
| 23 | + number of permitted VLANs may be less than 7 per | |
| 24 | + port, due to a maximum number of 32 VLAN retagging | |
| 25 | + rules per switch. | |
| 26 | + Configuration mode: runtime | |
| 27 | + Type: bool. | |
| @@ -14,6 +14,10 @@ Region snapshots are collected by the driver, and can be accessed via read · 13 unmodified lines | ||
| 14 | 14 | or dump commands. This allows future analysis on the created snapshots. |
| 15 | 15 | Regions may optionally support triggering snapshots on demand. |
| 16 | 16 | |
| 17 | +Snapshot identifiers are scoped to the devlink instance, not a region. | |
| 18 | +All snapshots with the same snapshot id within a devlink instance | |
| 19 | +correspond to the same event. | |
| 20 | + | |
| 17 | 21 | The major benefit to creating a region is to provide access to internal |
| 18 | 22 | address regions that are otherwise inaccessible to the user. |
| 19 | 23 | |
| @@ -23,7 +27,9 @@ states, but see also :doc:`devlink-health` · 3 unmodified lines | ||
| 23 | 27 | Regions may optionally support capturing a snapshot on demand via the |
| 24 | 28 | ``DEVLINK_CMD_REGION_NEW`` netlink message. A driver wishing to allow |
| 25 | 29 | requested snapshots must implement the ``.snapshot`` callback for the region |
| 26 | −in its ``devlink_region_ops`` structure. | |
| 30 | +in its ``devlink_region_ops`` structure. If snapshot id is not set in | |
| 31 | +the ``DEVLINK_CMD_REGION_NEW`` request kernel will allocate one and send | |
| 32 | +the snapshot information to user space. | |
| 27 | 33 | |
| 28 | 34 | example usage |
| 29 | 35 | ------------- |
| @@ -45,7 +51,8 @@ example usage · 15 unmodified lines | ||
| 45 | 51 | $ devlink region del pci/0000:00:05.0/cr-space snapshot 1 |
| 46 | 52 | |
| 47 | 53 | # Request an immediate snapshot, if supported by the region |
| 48 | − $ devlink region new pci/0000:00:05.0/cr-space snapshot 5 | |
| 54 | + $ devlink region new pci/0000:00:05.0/cr-space | |
| 55 | + pci/0000:00:05.0/cr-space: snapshot 5 | |
| 49 | 56 | |
| 50 | 57 | # Dump a snapshot: |
| 51 | 58 | $ devlink region dump pci/0000:00:05.0/fw-health snapshot 1 |
| @@ -55,7 +55,7 @@ The following diagram provides a general overview of ``devlink-trap``:: · 54 unmodified lines | ||
| 55 | 55 | | | |
| 56 | 56 | +-------^--------+ |
| 57 | 57 | | |
| 58 | − | | |
| 58 | + | Non-control traps | |
| 59 | 59 | | |
| 60 | 60 | +----+----+ |
| 61 | 61 | | | Kernel's Rx path |
| @@ -97,6 +97,12 @@ The ``devlink-trap`` mechanism supports the following packet trap types: · 35 unmodified lines | ||
| 97 | 97 | processed by ``devlink`` and injected to the kernel's Rx path. Changing the |
| 98 | 98 | action of such traps is not allowed, as it can easily break the control |
| 99 | 99 | plane. |
| 100 | + * ``control``: Trapped packets were trapped by the device because these are | |
| 101 | + control packets required for the correct functioning of the control plane. | |
| 102 | + For example, ARP request and IGMP query packets. Packets are injected to | |
| 103 | + the kernel's Rx path, but not reported to the kernel's drop monitor. | |
| 104 | + Changing the action of such traps is not allowed, as it can easily break | |
| 105 | + the control plane. | |
| 100 | 106 | |
| 101 | 107 | .. _Trap-Actions: |
| 102 | 108 | |
| @@ -108,6 +114,8 @@ The ``devlink-trap`` mechanism supports the following packet trap actions: · 5 unmodified lines | ||
| 108 | 114 | * ``trap``: The sole copy of the packet is sent to the CPU. |
| 109 | 115 | * ``drop``: The packet is dropped by the underlying device and a copy is not |
| 110 | 116 | sent to the CPU. |
| 117 | + * ``mirror``: The packet is forwarded by the underlying device and a copy is | |
| 118 | + sent to the CPU. | |
| 111 | 119 | |
| 112 | 120 | Generic Packet Traps |
| 113 | 121 | ==================== |
| @@ -244,6 +252,159 @@ be added to the following table: · 130 unmodified lines | ||
| 244 | 252 | * - ``egress_flow_action_drop`` |
| 245 | 253 | - ``drop`` |
| 246 | 254 | - Traps packets dropped during processing of egress flow action drop |
| 255 | + * - ``stp`` | |
| 256 | + - ``control`` | |
| 257 | + - Traps STP packets | |
| 258 | + * - ``lacp`` | |
| 259 | + - ``control`` | |
| 260 | + - Traps LACP packets | |
| 261 | + * - ``lldp`` | |
| 262 | + - ``control`` | |
| 263 | + - Traps LLDP packets | |
| 264 | + * - ``igmp_query`` | |
| 265 | + - ``control`` | |
| 266 | + - Traps IGMP Membership Query packets | |
| 267 | + * - ``igmp_v1_report`` | |
| 268 | + - ``control`` | |
| 269 | + - Traps IGMP Version 1 Membership Report packets | |
| 270 | + * - ``igmp_v2_report`` | |
| 271 | + - ``control`` | |
| 272 | + - Traps IGMP Version 2 Membership Report packets | |
| 273 | + * - ``igmp_v3_report`` | |
| 274 | + - ``control`` | |
| 275 | + - Traps IGMP Version 3 Membership Report packets | |
| 276 | + * - ``igmp_v2_leave`` | |
| 277 | + - ``control`` | |
| 278 | + - Traps IGMP Version 2 Leave Group packets | |
| 279 | + * - ``mld_query`` | |
| 280 | + - ``control`` | |
| 281 | + - Traps MLD Multicast Listener Query packets | |
| 282 | + * - ``mld_v1_report`` | |
| 283 | + - ``control`` | |
| 284 | + - Traps MLD Version 1 Multicast Listener Report packets | |
| 285 | + * - ``mld_v2_report`` | |
| 286 | + - ``control`` | |
| 287 | + - Traps MLD Version 2 Multicast Listener Report packets | |
| 288 | + * - ``mld_v1_done`` | |
| 289 | + - ``control`` | |
| 290 | + - Traps MLD Version 1 Multicast Listener Done packets | |
| 291 | + * - ``ipv4_dhcp`` | |
| 292 | + - ``control`` | |
| 293 | + - Traps IPv4 DHCP packets | |
| 294 | + * - ``ipv6_dhcp`` | |
| 295 | + - ``control`` | |
| 296 | + - Traps IPv6 DHCP packets | |
| 297 | + * - ``arp_request`` | |
| 298 | + - ``control`` | |
| 299 | + - Traps ARP request packets | |
| 300 | + * - ``arp_response`` | |
| 301 | + - ``control`` | |
| 302 | + - Traps ARP response packets | |
| 303 | + * - ``arp_overlay`` | |
| 304 | + - ``control`` | |
| 305 | + - Traps NVE-decapsulated ARP packets that reached the overlay network. | |
| 306 | + This is required, for example, when the address that needs to be | |
| 307 | + resolved is a local address | |
| 308 | + * - ``ipv6_neigh_solicit`` | |
| 309 | + - ``control`` | |
| 310 | + - Traps IPv6 Neighbour Solicitation packets | |
| 311 | + * - ``ipv6_neigh_advert`` | |
| 312 | + - ``control`` | |
| 313 | + - Traps IPv6 Neighbour Advertisement packets | |
| 314 | + * - ``ipv4_bfd`` | |
| 315 | + - ``control`` | |
| 316 | + - Traps IPv4 BFD packets | |
| 317 | + * - ``ipv6_bfd`` | |
| 318 | + - ``control`` | |
| 319 | + - Traps IPv6 BFD packets | |
| 320 | + * - ``ipv4_ospf`` | |
| 321 | + - ``control`` | |
| 322 | + - Traps IPv4 OSPF packets | |
| 323 | + * - ``ipv6_ospf`` | |
| 324 | + - ``control`` | |
| 325 | + - Traps IPv6 OSPF packets | |
| 326 | + * - ``ipv4_bgp`` | |
| 327 | + - ``control`` | |
| 328 | + - Traps IPv4 BGP packets | |
| 329 | + * - ``ipv6_bgp`` | |
| 330 | + - ``control`` | |
| 331 | + - Traps IPv6 BGP packets | |
| 332 | + * - ``ipv4_vrrp`` | |
| 333 | + - ``control`` | |
| 334 | + - Traps IPv4 VRRP packets | |
| 335 | + * - ``ipv6_vrrp`` | |
| 336 | + - ``control`` | |
| 337 | + - Traps IPv6 VRRP packets | |
| 338 | + * - ``ipv4_pim`` | |
| 339 | + - ``control`` | |
| 340 | + - Traps IPv4 PIM packets | |
| 341 | + * - ``ipv6_pim`` | |
| 342 | + - ``control`` | |
| 343 | + - Traps IPv6 PIM packets | |
| 344 | + * - ``uc_loopback`` | |
| 345 | + - ``control`` | |
| 346 | + - Traps unicast packets that need to be routed through the same layer 3 | |
| 347 | + interface from which they were received. Such packets are routed by the | |
| 348 | + kernel, but also cause it to potentially generate ICMP redirect packets | |
| 349 | + * - ``local_route`` | |
| 350 | + - ``control`` | |
| 351 | + - Traps unicast packets that hit a local route and need to be locally | |
| 352 | + delivered | |
| 353 | + * - ``external_route`` | |
| 354 | + - ``control`` | |
| 355 | + - Traps packets that should be routed through an external interface (e.g., | |
| 356 | + management interface) that does not belong to the same device (e.g., | |
| 357 | + switch ASIC) as the ingress interface | |
| 358 | + * - ``ipv6_uc_dip_link_local_scope`` | |
| 359 | + - ``control`` | |
| 360 | + - Traps unicast IPv6 packets that need to be routed and have a destination | |
| 361 | + IP address with a link-local scope (i.e., fe80::/10). The trap allows | |
| 362 | + device drivers to avoid programming link-local routes, but still receive | |
| 363 | + packets for local delivery | |
| 364 | + * - ``ipv6_dip_all_nodes`` | |
| 365 | + - ``control`` | |
| 366 | + - Traps IPv6 packets that their destination IP address is the "All Nodes | |
| 367 | + Address" (i.e., ff02::1) | |
| 368 | + * - ``ipv6_dip_all_routers`` | |
| 369 | + - ``control`` | |
| 370 | + - Traps IPv6 packets that their destination IP address is the "All Routers | |
| 371 | + Address" (i.e., ff02::2) | |
| 372 | + * - ``ipv6_router_solicit`` | |
| 373 | + - ``control`` | |
| 374 | + - Traps IPv6 Router Solicitation packets | |
| 375 | + * - ``ipv6_router_advert`` | |
| 376 | + - ``control`` | |
| 377 | + - Traps IPv6 Router Advertisement packets | |
| 378 | + * - ``ipv6_redirect`` | |
| 379 | + - ``control`` | |
| 380 | + - Traps IPv6 Redirect Message packets | |
| 381 | + * - ``ipv4_router_alert`` | |
| 382 | + - ``control`` | |
| 383 | + - Traps IPv4 packets that need to be routed and include the Router Alert | |
| 384 | + option. Such packets need to be locally delivered to raw sockets that | |
| 385 | + have the IP_ROUTER_ALERT socket option set | |
| 386 | + * - ``ipv6_router_alert`` | |
| 387 | + - ``control`` | |
| 388 | + - Traps IPv6 packets that need to be routed and include the Router Alert | |
| 389 | + option in their Hop-by-Hop extension header. Such packets need to be | |
| 390 | + locally delivered to raw sockets that have the IPV6_ROUTER_ALERT socket | |
| 391 | + option set | |
| 392 | + * - ``ptp_event`` | |
| 393 | + - ``control`` | |
| 394 | + - Traps PTP time-critical event messages (Sync, Delay_req, Pdelay_Req and | |
| 395 | + Pdelay_Resp) | |
| 396 | + * - ``ptp_general`` | |
| 397 | + - ``control`` | |
| 398 | + - Traps PTP general messages (Announce, Follow_Up, Delay_Resp, | |
| 399 | + Pdelay_Resp_Follow_Up, management and signaling) | |
| 400 | + * - ``flow_action_sample`` | |
| 401 | + - ``control`` | |
| 402 | + - Traps packets sampled during processing of flow action sample (e.g., via | |
| 403 | + tc's sample action) | |
| 404 | + * - ``flow_action_trap`` | |
| 405 | + - ``control`` | |
| 406 | + - Traps packets logged during processing of flow action trap (e.g., via | |
| 407 | + tc's trap action) | |
| 247 | 408 | |
| 248 | 409 | Driver-specific Packet Traps |
| 249 | 410 | ============================ |
| @@ -277,8 +438,11 @@ narrow. The description of these groups must be added to the following table: · 27 unmodified lines | ||
| 277 | 438 | - Contains packet traps for packets that were dropped by the device during |
| 278 | 439 | layer 2 forwarding (i.e., bridge) |
| 279 | 440 | * - ``l3_drops`` |
| 280 | − - Contains packet traps for packets that were dropped by the device or hit | |
| 281 | − an exception (e.g., TTL error) during layer 3 forwarding | |
| 441 | + - Contains packet traps for packets that were dropped by the device during | |
| 442 | + layer 3 forwarding | |
| 443 | + * - ``l3_exceptions`` | |
| 444 | + - Contains packet traps for packets that hit an exception (e.g., TTL | |
| 445 | + error) during layer 3 forwarding | |
| 282 | 446 | * - ``buffer_drops`` |
| 283 | 447 | - Contains packet traps for packets that were dropped by the device due to |
| 284 | 448 | an enqueue decision |
| @@ -288,6 +452,55 @@ narrow. The description of these groups must be added to the following table: · 3 unmodified lines | ||
| 288 | 452 | * - ``acl_drops`` |
| 289 | 453 | - Contains packet traps for packets that were dropped by the device during |
| 290 | 454 | ACL processing |
| 455 | + * - ``stp`` | |
| 456 | + - Contains packet traps for STP packets | |
| 457 | + * - ``lacp`` | |
| 458 | + - Contains packet traps for LACP packets | |
| 459 | + * - ``lldp`` | |
| 460 | + - Contains packet traps for LLDP packets | |
| 461 | + * - ``mc_snooping`` | |
| 462 | + - Contains packet traps for IGMP and MLD packets required for multicast | |
| 463 | + snooping | |
| 464 | + * - ``dhcp`` | |
| 465 | + - Contains packet traps for DHCP packets | |
| 466 | + * - ``neigh_discovery`` | |
| 467 | + - Contains packet traps for neighbour discovery packets (e.g., ARP, IPv6 | |
| 468 | + ND) | |
| 469 | + * - ``bfd`` | |
| 470 | + - Contains packet traps for BFD packets | |
| 471 | + * - ``ospf`` | |
| 472 | + - Contains packet traps for OSPF packets | |
| 473 | + * - ``bgp`` | |
| 474 | + - Contains packet traps for BGP packets | |
| 475 | + * - ``vrrp`` | |
| 476 | + - Contains packet traps for VRRP packets | |
| 477 | + * - ``pim`` | |
| 478 | + - Contains packet traps for PIM packets | |
| 479 | + * - ``uc_loopback`` | |
| 480 | + - Contains a packet trap for unicast loopback packets (i.e., | |
| 481 | + ``uc_loopback``). This trap is singled-out because in cases such as | |
| 482 | + one-armed router it will be constantly triggered. To limit the impact on | |
| 483 | + the CPU usage, a packet trap policer with a low rate can be bound to the | |
| 484 | + group without affecting other traps | |
| 485 | + * - ``local_delivery`` | |
| 486 | + - Contains packet traps for packets that should be locally delivered after | |
| 487 | + routing, but do not match more specific packet traps (e.g., | |
| 488 | + ``ipv4_bgp``) | |
| 489 | + * - ``ipv6`` | |
| 490 | + - Contains packet traps for various IPv6 control packets (e.g., Router | |
| 491 | + Advertisements) | |
| 492 | + * - ``ptp_event`` | |
| 493 | + - Contains packet traps for PTP time-critical event messages (Sync, | |
| 494 | + Delay_req, Pdelay_Req and Pdelay_Resp) | |
| 495 | + * - ``ptp_general`` | |
| 496 | + - Contains packet traps for PTP general messages (Announce, Follow_Up, | |
| 497 | + Delay_Resp, Pdelay_Resp_Follow_Up, management and signaling) | |
| 498 | + * - ``acl_sample`` | |
| 499 | + - Contains packet traps for packets that were sampled by the device during | |
| 500 | + ACL processing | |
| 501 | + * - ``acl_trap`` | |
| 502 | + - Contains packet traps for packets that were trapped (logged) by the | |
| 503 | + device during ACL processing | |
| 291 | 504 | |
| 292 | 505 | Packet Trap Policers |
| 293 | 506 | ==================== |
| @@ -69,6 +69,17 @@ The ``ice`` driver reports the following versions · 68 unmodified lines | ||
| 69 | 69 | - The version of the DDP package that is active in the device. Note |
| 70 | 70 | that both the name (as reported by ``fw.app.name``) and version are |
| 71 | 71 | required to uniquely identify the package. |
| 72 | + * - ``fw.netlist`` | |
| 73 | + - running | |
| 74 | + - 1.1.2000-6.7.0 | |
| 75 | + - The version of the netlist module. This module defines the device's | |
| 76 | + Ethernet capabilities and default settings, and is used by the | |
| 77 | + management firmware as part of managing link and device | |
| 78 | + connectivity. | |
| 79 | + * - ``fw.netlist.build`` | |
| 80 | + - running | |
| 81 | + - 0xee16ced7 | |
| 82 | + - The first 4 bytes of the hash of the netlist module contents. | |
| 72 | 83 | |
| 73 | 84 | Regions |
| 74 | 85 | ======= |
| @@ -1,8 +1,10 @@ | ||
| 1 | − =================== | |
| 2 | − DNS Resolver Module | |
| 3 | − =================== | |
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 4 | 2 | |
| 5 | −Contents: | |
| 3 | +=================== | |
| 4 | +DNS Resolver Module | |
| 5 | +=================== | |
| 6 | + | |
| 7 | +.. Contents: | |
| 6 | 8 | |
| 7 | 9 | - Overview. |
| 8 | 10 | - Compilation. |
| @@ -12,8 +14,7 @@ Contents: · 3 unmodified lines | ||
| 12 | 14 | - Debugging. |
| 13 | 15 | |
| 14 | 16 | |
| 15 | −======== | |
| 16 | −OVERVIEW | |
| 17 | +Overview | |
| 17 | 18 | ======== |
| 18 | 19 | |
| 19 | 20 | The DNS resolver module provides a way for kernel services to make DNS queries |
| @@ -33,50 +34,50 @@ It does not yet support the following AFS features: · 13 unmodified lines | ||
| 33 | 34 | This code is extracted from the CIFS filesystem. |
| 34 | 35 | |
| 35 | 36 | |
| 36 | −=========== | |
| 37 | −COMPILATION | |
| 37 | +Compilation | |
| 38 | 38 | =========== |
| 39 | 39 | |
| 40 | −The module should be enabled by turning on the kernel configuration options: | |
| 40 | +The module should be enabled by turning on the kernel configuration options:: | |
| 41 | 41 | |
| 42 | 42 | CONFIG_DNS_RESOLVER - tristate "DNS Resolver support" |
| 43 | 43 | |
| 44 | 44 | |
| 45 | −========== | |
| 46 | −SETTING UP | |
| 45 | +Setting up | |
| 47 | 46 | ========== |
| 48 | 47 | |
| 49 | 48 | To set up this facility, the /etc/request-key.conf file must be altered so that |
| 50 | 49 | /sbin/request-key can appropriately direct the upcalls. For example, to handle |
| 51 | 50 | basic dname to IPv4/IPv6 address resolution, the following line should be |
| 52 | −added: | |
| 51 | +added:: | |
| 52 | + | |
| 53 | 53 | |
| 54 | 54 | #OP TYPE DESC CO-INFO PROGRAM ARG1 ARG2 ARG3 ... |
| 55 | 55 | #====== ============ ======= ======= ========================== |
| 56 | 56 | create dns_resolver * * /usr/sbin/cifs.upcall %k |
| 57 | 57 | |
| 58 | 58 | To direct a query for query type 'foo', a line of the following should be added |
| 59 | −before the more general line given above as the first match is the one taken. | |
| 59 | +before the more general line given above as the first match is the one taken:: | |
| 60 | 60 | |
| 61 | 61 | create dns_resolver foo:* * /usr/sbin/dns.foo %k |
| 62 | 62 | |
| 63 | 63 | |
| 64 | −===== | |
| 65 | −USAGE | |
| 64 | +Usage | |
| 66 | 65 | ===== |
| 67 | 66 | |
| 68 | 67 | To make use of this facility, one of the following functions that are |
| 69 | −implemented in the module can be called after doing: | |
| 68 | +implemented in the module can be called after doing:: | |
| 70 | 69 | |
| 71 | 70 | #include <linux/dns_resolver.h> |
| 72 | 71 | |
| 73 | − (1) int dns_query(const char *type, const char *name, size_t namelen, | |
| 74 | − const char *options, char **_result, time_t *_expiry); | |
| 72 | + :: | |
| 73 | + | |
| 74 | + int dns_query(const char *type, const char *name, size_t namelen, | |
| 75 | + const char *options, char **_result, time_t *_expiry); | |
| 75 | 76 | |
| 76 | 77 | This is the basic access function. It looks for a cached DNS query and if |
| 77 | 78 | it doesn't find it, it upcalls to userspace to make a new DNS query, which |
| 78 | 79 | may then be cached. The key description is constructed as a string of the |
| 79 | − form: | |
| 80 | + form:: | |
| 80 | 81 | |
| 81 | 82 | [<type>:]<name> |
| 82 | 83 | |
| @@ -107,16 +108,14 @@ This can be cleared by any process that has the CAP_SYS_ADMIN capability by · 24 unmodified lines | ||
| 107 | 108 | the use of KEYCTL_KEYRING_CLEAR on the keyring ID. |
| 108 | 109 | |
| 109 | 110 | |
| 110 | −=============================== | |
| 111 | −READING DNS KEYS FROM USERSPACE | |
| 111 | +Reading DNS Keys from Userspace | |
| 112 | 112 | =============================== |
| 113 | 113 | |
| 114 | 114 | Keys of dns_resolver type can be read from userspace using keyctl_read() or |
| 115 | 115 | "keyctl read/print/pipe". |
| 116 | 116 | |
| 117 | 117 | |
| 118 | −========= | |
| 119 | −MECHANISM | |
| 118 | +Mechanism | |
| 120 | 119 | ========= |
| 121 | 120 | |
| 122 | 121 | The dnsresolver module registers a key type called "dns_resolver". Keys of |
| @@ -147,11 +146,10 @@ See <file:Documentation/security/keys/request-key.rst> for further · 24 unmodified lines | ||
| 147 | 146 | information about request-key function. |
| 148 | 147 | |
| 149 | 148 | |
| 150 | −========= | |
| 151 | −DEBUGGING | |
| 149 | +Debugging | |
| 152 | 150 | ========= |
| 153 | 151 | |
| 154 | 152 | Debugging messages can be turned on dynamically by writing a 1 into the |
| 155 | −following file: | |
| 153 | +following file:: | |
| 156 | 154 | |
| 157 | − /sys/module/dnsresolver/parameters/debug | |
| 155 | + /sys/module/dnsresolver/parameters/debug | |
| @@ -1,4 +1,8 @@ | ||
| 1 | −Document about softnet driver issues | |
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +===================== | |
| 4 | +Softnet Driver Issues | |
| 5 | +===================== | |
| 2 | 6 | |
| 3 | 7 | Transmit path guidelines: |
| 4 | 8 | |
| @@ -8,7 +12,7 @@ Transmit path guidelines: · 3 unmodified lines | ||
| 8 | 12 | transmit function will become busy. |
| 9 | 13 | |
| 10 | 14 | Instead it must maintain the queue properly. For example, |
| 11 | − for a driver implementing scatter-gather this means: | |
| 15 | + for a driver implementing scatter-gather this means:: | |
| 12 | 16 | |
| 13 | 17 | static netdev_tx_t drv_hard_start_xmit(struct sk_buff *skb, |
| 14 | 18 | struct net_device *dev) |
| @@ -38,25 +42,25 @@ Transmit path guidelines: · 23 unmodified lines | ||
| 38 | 42 | return NETDEV_TX_OK; |
| 39 | 43 | } |
| 40 | 44 | |
| 41 | − And then at the end of your TX reclamation event handling: | |
| 45 | + And then at the end of your TX reclamation event handling:: | |
| 42 | 46 | |
| 43 | 47 | if (netif_queue_stopped(dp->dev) && |
| 44 | − TX_BUFFS_AVAIL(dp) > (MAX_SKB_FRAGS + 1)) | |
| 48 | + TX_BUFFS_AVAIL(dp) > (MAX_SKB_FRAGS + 1)) | |
| 45 | 49 | netif_wake_queue(dp->dev); |
| 46 | 50 | |
| 47 | − For a non-scatter-gather supporting card, the three tests simply become: | |
| 51 | + For a non-scatter-gather supporting card, the three tests simply become:: | |
| 48 | 52 | |
| 49 | 53 | /* This is a hard error log it. */ |
| 50 | 54 | if (TX_BUFFS_AVAIL(dp) <= 0) |
| 51 | 55 | |
| 52 | − and: | |
| 56 | + and:: | |
| 53 | 57 | |
| 54 | 58 | if (TX_BUFFS_AVAIL(dp) == 0) |
| 55 | 59 | |
| 56 | − and: | |
| 60 | + and:: | |
| 57 | 61 | |
| 58 | 62 | if (netif_queue_stopped(dp->dev) && |
| 59 | − TX_BUFFS_AVAIL(dp) > 0) | |
| 63 | + TX_BUFFS_AVAIL(dp) > 0) | |
| 60 | 64 | netif_wake_queue(dp->dev); |
| 61 | 65 | |
| 62 | 66 | 2) An ndo_start_xmit method must not modify the shared parts of a |
| @@ -86,7 +90,7 @@ Close/stop guidelines: · 23 unmodified lines | ||
| 86 | 90 | |
| 87 | 91 | 1) After the ndo_stop routine has been called, the hardware must |
| 88 | 92 | not receive or transmit any data. All in flight packets must |
| 89 | − be aborted. If necessary, poll or wait for completion of | |
| 93 | + be aborted. If necessary, poll or wait for completion of | |
| 90 | 94 | any reset commands. |
| 91 | 95 | |
| 92 | 96 | 2) The ndo_stop routine will be called by unregister_netdevice |
| @@ -66,34 +66,193 @@ reprogrammed with the updated static configuration. · 65 unmodified lines | ||
| 66 | 66 | Traffic support |
| 67 | 67 | =============== |
| 68 | 68 | |
| 69 | −The switches do not support switch tagging in hardware. But they do support | |
| 70 | −customizing the TPID by which VLAN traffic is identified as such. The switch | |
| 71 | −driver is leveraging ``CONFIG_NET_DSA_TAG_8021Q`` by requesting that special | |
| 72 | −VLANs (with a custom TPID of ``ETH_P_EDSA`` instead of ``ETH_P_8021Q``) are | |
| 73 | −installed on its ports when not in ``vlan_filtering`` mode. This does not | |
| 74 | −interfere with the reception and transmission of real 802.1Q-tagged traffic, | |
| 75 | −because the switch does no longer parse those packets as VLAN after the TPID | |
| 76 | −change. | |
| 77 | −The TPID is restored when ``vlan_filtering`` is requested by the user through | |
| 78 | −the bridge layer, and general IP termination becomes no longer possible through | |
| 79 | −the switch netdevices in this mode. | |
| 80 | − | |
| 81 | −The switches have two programmable filters for link-local destination MACs. | |
| 69 | +The switches do not have hardware support for DSA tags, except for "slow | |
| 70 | +protocols" for switch control as STP and PTP. For these, the switches have two | |
| 71 | +programmable filters for link-local destination MACs. | |
| 82 | 72 | These are used to trap BPDUs and PTP traffic to the master netdevice, and are |
| 83 | 73 | further used to support STP and 1588 ordinary clock/boundary clock |
| 84 | −functionality. | |
| 85 | − | |
| 86 | −The following traffic modes are supported over the switch netdevices: | |
| 87 | − | |
| 88 | −+--------------------+------------+------------------+------------------+ | |
| 89 | −| | Standalone | Bridged with | Bridged with | | |
| 90 | −| | ports | vlan_filtering 0 | vlan_filtering 1 | | |
| 91 | −+====================+============+==================+==================+ | |
| 92 | −| Regular traffic | Yes | Yes | No (use master) | | |
| 93 | −+--------------------+------------+------------------+------------------+ | |
| 94 | −| Management traffic | Yes | Yes | Yes | | |
| 95 | −| (BPDU, PTP) | | | | | |
| 96 | −+--------------------+------------+------------------+------------------+ | |
| 74 | +functionality. For frames trapped to the CPU, source port and switch ID | |
| 75 | +information is encoded by the hardware into the frames. | |
| 76 | + | |
| 77 | +But by leveraging ``CONFIG_NET_DSA_TAG_8021Q`` (a software-defined DSA tagging | |
| 78 | +format based on VLANs), general-purpose traffic termination through the network | |
| 79 | +stack can be supported under certain circumstances. | |
| 80 | + | |
| 81 | +Depending on VLAN awareness state, the following operating modes are possible | |
| 82 | +with the switch: | |
| 83 | + | |
| 84 | +- Mode 1 (VLAN-unaware): a port is in this mode when it is used as a standalone | |
| 85 | + net device, or when it is enslaved to a bridge with ``vlan_filtering=0``. | |
| 86 | +- Mode 2 (fully VLAN-aware): a port is in this mode when it is enslaved to a | |
| 87 | + bridge with ``vlan_filtering=1``. Access to the entire VLAN range is given to | |
| 88 | + the user through ``bridge vlan`` commands, but general-purpose (anything | |
| 89 | + other than STP, PTP etc) traffic termination is not possible through the | |
| 90 | + switch net devices. The other packets can be still by user space processed | |
| 91 | + through the DSA master interface (similar to ``DSA_TAG_PROTO_NONE``). | |
| 92 | +- Mode 3 (best-effort VLAN-aware): a port is in this mode when enslaved to a | |
| 93 | + bridge with ``vlan_filtering=1``, and the devlink property of its parent | |
| 94 | + switch named ``best_effort_vlan_filtering`` is set to ``true``. When | |
| 95 | + configured like this, the range of usable VIDs is reduced (0 to 1023 and 3072 | |
| 96 | + to 4094), so is the number of usable VIDs (maximum of 7 non-pvid VLANs per | |
| 97 | + port*), and shared VLAN learning is performed (FDB lookup is done only by | |
| 98 | + DMAC, not also by VID). | |
| 99 | + | |
| 100 | +To summarize, in each mode, the following types of traffic are supported over | |
| 101 | +the switch net devices: | |
| 102 | + | |
| 103 | ++-------------+-----------+--------------+------------+ | |
| 104 | +| | Mode 1 | Mode 2 | Mode 3 | | |
| 105 | ++=============+===========+==============+============+ | |
| 106 | +| Regular | Yes | No | Yes | | |
| 107 | +| traffic | | (use master) | | | |
| 108 | ++-------------+-----------+--------------+------------+ | |
| 109 | +| Management | Yes | Yes | Yes | | |
| 110 | +| traffic | | | | | |
| 111 | +| (BPDU, PTP) | | | | | |
| 112 | ++-------------+-----------+--------------+------------+ | |
| 113 | + | |
| 114 | +To configure the switch to operate in Mode 3, the following steps can be | |
| 115 | +followed:: | |
| 116 | + | |
| 117 | + ip link add dev br0 type bridge | |
| 118 | + # swp2 operates in Mode 1 now | |
| 119 | + ip link set dev swp2 master br0 | |
| 120 | + # swp2 temporarily moves to Mode 2 | |
| 121 | + ip link set dev br0 type bridge vlan_filtering 1 | |
| 122 | + [ 61.204770] sja1105 spi0.1: Reset switch and programmed static config. Reason: VLAN filtering | |
| 123 | + [ 61.239944] sja1105 spi0.1: Disabled switch tagging | |
| 124 | + # swp3 now operates in Mode 3 | |
| 125 | + devlink dev param set spi/spi0.1 name best_effort_vlan_filtering value true cmode runtime | |
| 126 | + [ 64.682927] sja1105 spi0.1: Reset switch and programmed static config. Reason: VLAN filtering | |
| 127 | + [ 64.711925] sja1105 spi0.1: Enabled switch tagging | |
| 128 | + # Cannot use VLANs in range 1024-3071 while in Mode 3. | |
| 129 | + bridge vlan add dev swp2 vid 1025 untagged pvid | |
| 130 | + RTNETLINK answers: Operation not permitted | |
| 131 | + bridge vlan add dev swp2 vid 100 | |
| 132 | + bridge vlan add dev swp2 vid 101 untagged | |
| 133 | + bridge vlan | |
| 134 | + port vlan ids | |
| 135 | + swp5 1 PVID Egress Untagged | |
| 136 | + | |
| 137 | + swp2 1 PVID Egress Untagged | |
| 138 | + 100 | |
| 139 | + 101 Egress Untagged | |
| 140 | + | |
| 141 | + swp3 1 PVID Egress Untagged | |
| 142 | + | |
| 143 | + swp4 1 PVID Egress Untagged | |
| 144 | + | |
| 145 | + br0 1 PVID Egress Untagged | |
| 146 | + bridge vlan add dev swp2 vid 102 | |
| 147 | + bridge vlan add dev swp2 vid 103 | |
| 148 | + bridge vlan add dev swp2 vid 104 | |
| 149 | + bridge vlan add dev swp2 vid 105 | |
| 150 | + bridge vlan add dev swp2 vid 106 | |
| 151 | + bridge vlan add dev swp2 vid 107 | |
| 152 | + # Cannot use mode than 7 VLANs per port while in Mode 3. | |
| 153 | + [ 3885.216832] sja1105 spi0.1: No more free subvlans | |
| 154 | + | |
| 155 | +\* "maximum of 7 non-pvid VLANs per port": Decoding VLAN-tagged packets on the | |
| 156 | +CPU in mode 3 is possible through VLAN retagging of packets that go from the | |
| 157 | +switch to the CPU. In cross-chip topologies, the port that goes to the CPU | |
| 158 | +might also go to other switches. In that case, those other switches will see | |
| 159 | +only a retagged packet (which only has meaning for the CPU). So if they are | |
| 160 | +interested in this VLAN, they need to apply retagging in the reverse direction, | |
| 161 | +to recover the original value from it. This consumes extra hardware resources | |
| 162 | +for this switch. There is a maximum of 32 entries in the Retagging Table of | |
| 163 | +each switch device. | |
| 164 | + | |
| 165 | +As an example, consider this cross-chip topology:: | |
| 166 | + | |
| 167 | + +-------------------------------------------------+ | |
| 168 | + | Host SoC | | |
| 169 | + | +-------------------------+ | | |
| 170 | + | | DSA master for embedded | | | |
| 171 | + | | switch (non-sja1105) | | | |
| 172 | + | +--------+-------------------------+--------+ | | |
| 173 | + | | embedded L2 switch | | | |
| 174 | + | | | | | |
| 175 | + | | +--------------+ +--------------+ | | | |
| 176 | + | | |DSA master for| |DSA master for| | | | |
| 177 | + | | | SJA1105 1 | | SJA1105 2 | | | | |
| 178 | + +--+---+--------------+-----+--------------+---+--+ | |
| 179 | + | |
| 180 | + +-----------------------+ +-----------------------+ | |
| 181 | + | SJA1105 switch 1 | | SJA1105 switch 2 | | |
| 182 | + +-----+-----+-----+-----+ +-----+-----+-----+-----+ | |
| 183 | + |sw1p0|sw1p1|sw1p2|sw1p3| |sw2p0|sw2p1|sw2p2|sw2p3| | |
| 184 | + +-----+-----+-----+-----+ +-----+-----+-----+-----+ | |
| 185 | + | |
| 186 | +To reach the CPU, SJA1105 switch 1 (spi/spi2.1) uses the same port as is uses | |
| 187 | +to reach SJA1105 switch 2 (spi/spi2.2), which would be port 4 (not drawn). | |
| 188 | +Similarly for SJA1105 switch 2. | |
| 189 | + | |
| 190 | +Also consider the following commands, that add VLAN 100 to every sja1105 user | |
| 191 | +port:: | |
| 192 | + | |
| 193 | + devlink dev param set spi/spi2.1 name best_effort_vlan_filtering value true cmode runtime | |
| 194 | + devlink dev param set spi/spi2.2 name best_effort_vlan_filtering value true cmode runtime | |
| 195 | + ip link add dev br0 type bridge | |
| 196 | + for port in sw1p0 sw1p1 sw1p2 sw1p3 \ | |
| 197 | + sw2p0 sw2p1 sw2p2 sw2p3; do | |
| 198 | + ip link set dev $port master br0 | |
| 199 | + done | |
| 200 | + ip link set dev br0 type bridge vlan_filtering 1 | |
| 201 | + for port in sw1p0 sw1p1 sw1p2 sw1p3 \ | |
| 202 | + sw2p0 sw2p1 sw2p2; do | |
| 203 | + bridge vlan add dev $port vid 100 | |
| 204 | + done | |
| 205 | + ip link add link br0 name br0.100 type vlan id 100 && ip link set dev br0.100 up | |
| 206 | + ip addr add 192.168.100.3/24 dev br0.100 | |
| 207 | + bridge vlan add dev br0 vid 100 self | |
| 208 | + | |
| 209 | + bridge vlan | |
| 210 | + port vlan ids | |
| 211 | + sw1p0 1 PVID Egress Untagged | |
| 212 | + 100 | |
| 213 | + | |
| 214 | + sw1p1 1 PVID Egress Untagged | |
| 215 | + 100 | |
| 216 | + | |
| 217 | + sw1p2 1 PVID Egress Untagged | |
| 218 | + 100 | |
| 219 | + | |
| 220 | + sw1p3 1 PVID Egress Untagged | |
| 221 | + 100 | |
| 222 | + | |
| 223 | + sw2p0 1 PVID Egress Untagged | |
| 224 | + 100 | |
| 225 | + | |
| 226 | + sw2p1 1 PVID Egress Untagged | |
| 227 | + 100 | |
| 228 | + | |
| 229 | + sw2p2 1 PVID Egress Untagged | |
| 230 | + 100 | |
| 231 | + | |
| 232 | + sw2p3 1 PVID Egress Untagged | |
| 233 | + | |
| 234 | + br0 1 PVID Egress Untagged | |
| 235 | + 100 | |
| 236 | + | |
| 237 | +SJA1105 switch 1 consumes 1 retagging entry for each VLAN on each user port | |
| 238 | +towards the CPU. It also consumes 1 retagging entry for each non-pvid VLAN that | |
| 239 | +it is also interested in, which is configured on any port of any neighbor | |
| 240 | +switch. | |
| 241 | + | |
| 242 | +In this case, SJA1105 switch 1 consumes a total of 11 retagging entries, as | |
| 243 | +follows: | |
| 244 | +- 8 retagging entries for VLANs 1 and 100 installed on its user ports | |
| 245 | + (``sw1p0`` - ``sw1p3``) | |
| 246 | +- 3 retagging entries for VLAN 100 installed on the user ports of SJA1105 | |
| 247 | + switch 2 (``sw2p0`` - ``sw2p2``), because it also has ports that are | |
| 248 | + interested in it. The VLAN 1 is a pvid on SJA1105 switch 2 and does not need | |
| 249 | + reverse retagging. | |
| 250 | + | |
| 251 | +SJA1105 switch 2 also consumes 11 retagging entries, but organized as follows: | |
| 252 | +- 7 retagging entries for the bridge VLANs on its user ports (``sw2p0`` - | |
| 253 | + ``sw2p3``). | |
| 254 | +- 4 retagging entries for VLAN 100 installed on the user ports of SJA1105 | |
| 255 | + switch 1 (``sw1p0`` - ``sw1p3``). | |
| 97 | 256 | |
| 98 | 257 | Switching features |
| 99 | 258 | ================== |
| @@ -230,6 +389,122 @@ simultaneously on two ports. The driver checks the consistency of the schedules · 130 unmodified lines | ||
| 230 | 389 | against this restriction and errors out when appropriate. Schedule analysis is |
| 231 | 390 | needed to avoid this, which is outside the scope of the document. |
| 232 | 391 | |
| 392 | +Routing actions (redirect, trap, drop) | |
| 393 | +-------------------------------------- | |
| 394 | + | |
| 395 | +The switch is able to offload flow-based redirection of packets to a set of | |
| 396 | +destination ports specified by the user. Internally, this is implemented by | |
| 397 | +making use of Virtual Links, a TTEthernet concept. | |
| 398 | + | |
| 399 | +The driver supports 2 types of keys for Virtual Links: | |
| 400 | + | |
| 401 | +- VLAN-aware virtual links: these match on destination MAC address, VLAN ID and | |
| 402 | + VLAN PCP. | |
| 403 | +- VLAN-unaware virtual links: these match on destination MAC address only. | |
| 404 | + | |
| 405 | +The VLAN awareness state of the bridge (vlan_filtering) cannot be changed while | |
| 406 | +there are virtual link rules installed. | |
| 407 | + | |
| 408 | +Composing multiple actions inside the same rule is supported. When only routing | |
| 409 | +actions are requested, the driver creates a "non-critical" virtual link. When | |
| 410 | +the action list also contains tc-gate (more details below), the virtual link | |
| 411 | +becomes "time-critical" (draws frame buffers from a reserved memory partition, | |
| 412 | +etc). | |
| 413 | + | |
| 414 | +The 3 routing actions that are supported are "trap", "drop" and "redirect". | |
| 415 | + | |
| 416 | +Example 1: send frames received on swp2 with a DA of 42:be:24:9b:76:20 to the | |
| 417 | +CPU and to swp3. This type of key (DA only) when the port's VLAN awareness | |
| 418 | +state is off:: | |
| 419 | + | |
| 420 | + tc qdisc add dev swp2 clsact | |
| 421 | + tc filter add dev swp2 ingress flower skip_sw dst_mac 42:be:24:9b:76:20 \ | |
| 422 | + action mirred egress redirect dev swp3 \ | |
| 423 | + action trap | |
| 424 | + | |
| 425 | +Example 2: drop frames received on swp2 with a DA of 42:be:24:9b:76:20, a VID | |
| 426 | +of 100 and a PCP of 0:: | |
| 427 | + | |
| 428 | + tc filter add dev swp2 ingress protocol 802.1Q flower skip_sw \ | |
| 429 | + dst_mac 42:be:24:9b:76:20 vlan_id 100 vlan_prio 0 action drop | |
| 430 | + | |
| 431 | +Time-based ingress policing | |
| 432 | +--------------------------- | |
| 433 | + | |
| 434 | +The TTEthernet hardware abilities of the switch can be constrained to act | |
| 435 | +similarly to the Per-Stream Filtering and Policing (PSFP) clause specified in | |
| 436 | +IEEE 802.1Q-2018 (formerly 802.1Qci). This means it can be used to perform | |
| 437 | +tight timing-based admission control for up to 1024 flows (identified by a | |
| 438 | +tuple composed of destination MAC address, VLAN ID and VLAN PCP). Packets which | |
| 439 | +are received outside their expected reception window are dropped. | |
| 440 | + | |
| 441 | +This capability can be managed through the offload of the tc-gate action. As | |
| 442 | +routing actions are intrinsic to virtual links in TTEthernet (which performs | |
| 443 | +explicit routing of time-critical traffic and does not leave that in the hands | |
| 444 | +of the FDB, flooding etc), the tc-gate action may never appear alone when | |
| 445 | +asking sja1105 to offload it. One (or more) redirect or trap actions must also | |
| 446 | +follow along. | |
| 447 | + | |
| 448 | +Example: create a tc-taprio schedule that is phase-aligned with a tc-gate | |
| 449 | +schedule (the clocks must be synchronized by a 1588 application stack, which is | |
| 450 | +outside the scope of this document). No packet delivered by the sender will be | |
| 451 | +dropped. Note that the reception window is larger than the transmission window | |
| 452 | +(and much more so, in this example) to compensate for the packet propagation | |
| 453 | +delay of the link (which can be determined by the 1588 application stack). | |
| 454 | + | |
| 455 | +Receiver (sja1105):: | |
| 456 | + | |
| 457 | + tc qdisc add dev swp2 clsact | |
| 458 | + now=$(phc_ctl /dev/ptp1 get | awk '/clock time is/ {print $5}') && \ | |
| 459 | + sec=$(echo $now | awk -F. '{print $1}') && \ | |
| 460 | + base_time="$(((sec + 2) * 1000000000))" && \ | |
| 461 | + echo "base time ${base_time}" | |
| 462 | + tc filter add dev swp2 ingress flower skip_sw \ | |
| 463 | + dst_mac 42:be:24:9b:76:20 \ | |
| 464 | + action gate base-time ${base_time} \ | |
| 465 | + sched-entry OPEN 60000 -1 -1 \ | |
| 466 | + sched-entry CLOSE 40000 -1 -1 \ | |
| 467 | + action trap | |
| 468 | + | |
| 469 | +Sender:: | |
| 470 | + | |
| 471 | + now=$(phc_ctl /dev/ptp0 get | awk '/clock time is/ {print $5}') && \ | |
| 472 | + sec=$(echo $now | awk -F. '{print $1}') && \ | |
| 473 | + base_time="$(((sec + 2) * 1000000000))" && \ | |
| 474 | + echo "base time ${base_time}" | |
| 475 | + tc qdisc add dev eno0 parent root taprio \ | |
| 476 | + num_tc 8 \ | |
| 477 | + map 0 1 2 3 4 5 6 7 \ | |
| 478 | + queues 1@0 1@1 1@2 1@3 1@4 1@5 1@6 1@7 \ | |
| 479 | + base-time ${base_time} \ | |
| 480 | + sched-entry S 01 50000 \ | |
| 481 | + sched-entry S 00 50000 \ | |
| 482 | + flags 2 | |
| 483 | + | |
| 484 | +The engine used to schedule the ingress gate operations is the same that the | |
| 485 | +one used for the tc-taprio offload. Therefore, the restrictions regarding the | |
| 486 | +fact that no two gate actions (either tc-gate or tc-taprio gates) may fire at | |
| 487 | +the same time (during the same 200 ns slot) still apply. | |
| 488 | + | |
| 489 | +To come in handy, it is possible to share time-triggered virtual links across | |
| 490 | +more than 1 ingress port, via flow blocks. In this case, the restriction of | |
| 491 | +firing at the same time does not apply because there is a single schedule in | |
| 492 | +the system, that of the shared virtual link:: | |
| 493 | + | |
| 494 | + tc qdisc add dev swp2 ingress_block 1 clsact | |
| 495 | + tc qdisc add dev swp3 ingress_block 1 clsact | |
| 496 | + tc filter add block 1 flower skip_sw dst_mac 42:be:24:9b:76:20 \ | |
| 497 | + action gate index 2 \ | |
| 498 | + base-time 0 \ | |
| 499 | + sched-entry OPEN 50000000 -1 -1 \ | |
| 500 | + sched-entry CLOSE 50000000 -1 -1 \ | |
| 501 | + action trap | |
| 502 | + | |
| 503 | +Hardware statistics for each flow are also available ("pkts" counts the number | |
| 504 | +of dropped frames, which is a sum of frames dropped due to timing violations, | |
| 505 | +lack of destination ports and MTU enforcement checks). Byte-level counters are | |
| 506 | +not available. | |
| 507 | + | |
| 233 | 508 | Device Tree bindings and board design |
| 234 | 509 | ===================================== |
| 235 | 510 | |
| @@ -1,5 +1,11 @@ | ||
| 1 | − EQL Driver: Serial IP Load Balancing HOWTO | |
| 1 | +.. SPDX-License-Identifier: GPL-2.0 | |
| 2 | + | |
| 3 | +========================================== | |
| 4 | +EQL Driver: Serial IP Load Balancing HOWTO | |
| 5 | +========================================== | |
| 6 | + | |
| 2 | 7 | Simon "Guru Aleph-Null" Janes, simon@ncm.com |
| 8 | + | |
| 3 | 9 | v1.1, February 27, 1995 |
| 4 | 10 | |
| 5 | 11 | This is the manual for the EQL device driver. EQL is a software device |
| @@ -12,7 +18,8 @@ · 6 unmodified lines | ||
| 12 | 18 | which was only created to patch cleanly in the very latest kernel |
| 13 | 19 | source trees. (Yes, it worked fine.) |
| 14 | 20 | |
| 15 | − 1. Introduction | |
| 21 | +1. Introduction | |
| 22 | +=============== | |
| 16 | 23 | |
| 17 | 24 | Which is worse? A huge fee for a 56K leased line or two phone lines? |
| 18 | 25 | It's probably the former. If you find yourself craving more bandwidth, |
| @@ -41,47 +48,40 @@ · 22 unmodified lines | ||
| 41 | 48 | Hey, we can all dream you know... |
| 42 | 49 | |
| 43 | 50 | |
| 44 | − 2. Kernel Configuration | |
| 51 | +2. Kernel Configuration | |
| 52 | +======================= | |
| 45 | 53 | |
| 46 | 54 | Here I describe the general steps of getting a kernel up and working |
| 47 | 55 | with the eql driver. From patching, building, to installing. |
| 48 | 56 | |
| 49 | 57 | |
| 50 | − 2.1. Patching The Kernel | |
| 58 | +2.1. Patching The Kernel | |
| 59 | +------------------------ | |
| 51 | 60 | |
| 52 | 61 | If you do not have or cannot get a copy of the kernel with the eql |
| 53 | 62 | driver folded into it, get your copy of the driver from |
| 54 | 63 | ftp://slaughter.ncm.com/pub/Linux/LOAD_BALANCING/eql-1.1.tar.gz. |
| 55 | 64 | Unpack this archive someplace obvious like /usr/local/src/. It will |
| 56 | − create the following files: | |
| 57 | − | |
| 58 | − | |
| 65 | + create the following files:: | |
| 59 | 66 | |
| 60 | − ______________________________________________________________________ | |
| 61 | 67 | -rw-r--r-- guru/ncm 198 Jan 19 18:53 1995 eql-1.1/NO-WARRANTY |
| 62 | 68 | -rw-r--r-- guru/ncm 30620 Feb 27 21:40 1995 eql-1.1/eql-1.1.patch |
| 63 | 69 | -rwxr-xr-x guru/ncm 16111 Jan 12 22:29 1995 eql-1.1/eql_enslave |
| 64 | 70 | -rw-r--r-- guru/ncm 2195 Jan 10 21:48 1995 eql-1.1/eql_enslave.c |
| 65 | − ______________________________________________________________________ | |
| 66 | 71 | |
| 67 | 72 | Unpack a recent kernel (something after 1.1.92) someplace convenient |
| 68 | 73 | like say /usr/src/linux-1.1.92.eql. Use symbolic links to point |
| 69 | 74 | /usr/src/linux to this development directory. |
| 70 | 75 | |
| 71 | 76 | |
| 72 | − Apply the patch by running the commands: | |
| 77 | + Apply the patch by running the commands:: | |
| 73 | 78 | |
| 74 | − | |
| 75 | − ______________________________________________________________________ | |
| 76 | 79 | cd /usr/src |
| 77 | 80 | patch </usr/local/src/eql-1.1/eql-1.1.patch |
| 78 | − ______________________________________________________________________ | |
| 79 | − | |
| 80 | − | |
| 81 | 81 | |
| 82 | 82 | |
| 83 | − | |
| 84 | − 2.2. Building The Kernel | |
| 83 | +2.2. Building The Kernel | |
| 84 | +------------------------ | |
| 85 | 85 | |
| 86 | 86 | After patching the kernel, run make config and configure the kernel |
| 87 | 87 | for your hardware. |
| @@ -90,7 +90,8 @@ · 2 unmodified lines | ||
| 90 | 90 | After configuration, make and install according to your habit. |
| 91 | 91 | |
| 92 | 92 | |
| 93 | − 3. Network Configuration | |
| 93 | +3. Network Configuration | |
| 94 | +======================== | |
| 94 | 95 | |
| 95 | 96 | So far, I have only used the eql device with the DSLIP SLIP connection |
| 96 | 97 | manager by Matt Dillon (-- "The man who sold his soul to code so much |
| @@ -100,37 +101,27 @@ · 3 unmodified lines | ||
| 100 | 101 | connection. |
| 101 | 102 | |
| 102 | 103 | |
| 103 | − 3.1. /etc/rc.d/rc.inet1 | |
| 104 | +3.1. /etc/rc.d/rc.inet1 | |
| 105 | +----------------------- | |
| 104 | 106 | |
| 105 | 107 | In rc.inet1, ifconfig the eql device to the IP address you usually use |
| 106 | 108 | for your machine, and the MTU you prefer for your SLIP lines. One |
| 107 | 109 | could argue that MTU should be roughly half the usual size for two |
| 108 | 110 | modems, one-third for three, one-fourth for four, etc... But going |
| 109 | 111 | too far below 296 is probably overkill. Here is an example ifconfig |
| 110 | − command that sets up the eql device: | |
| 111 | − | |
| 112 | + command that sets up the eql device:: | |
| 112 | 113 | |
| 113 | − | |
| 114 | − ______________________________________________________________________ | |
| 115 | 114 | ifconfig eql 198.67.33.239 mtu 1006 |
| 116 | − ______________________________________________________________________ | |
| 117 | − | |
| 118 | − | |
| 119 | − | |
| 120 | − | |
| 121 | 115 | |
| 122 | 116 | Once the eql device is up and running, add a static default route to |
| 123 | 117 | it in the routing table using the cool new route syntax that makes |
| 124 | − life so much easier: | |
| 118 | + life so much easier:: | |
| 125 | 119 | |
| 126 | − | |
| 127 | − | |
| 128 | − ______________________________________________________________________ | |
| 129 | 120 | route add default eql |
| 130 | − ______________________________________________________________________ | |
| 131 | 121 | |
| 132 | 122 | |
| 133 | − 3.2. Enslaving Devices By Hand | |
| 123 | +3.2. Enslaving Devices By Hand | |
| 124 | +------------------------------ | |
| 134 | 125 | |
| 135 | 126 | Enslaving devices by hand requires two utility programs: eql_enslave |
| 136 | 127 | and eql_emancipate (-- eql_emancipate hasn't been written because when |
| @@ -140,87 +131,56 @@ · 3 unmodified lines | ||
| 140 | 131 | |
| 141 | 132 | |
| 142 | 133 | The syntax for enslaving a device is "eql_enslave <master-name> |
| 143 | − <slave-name> <estimated-bps>". Here are some example enslavings: | |
| 144 | − | |
| 134 | + <slave-name> <estimated-bps>". Here are some example enslavings:: | |
| 145 | 135 | |
| 146 | − | |
| 147 | − ______________________________________________________________________ | |
| 148 | 136 | eql_enslave eql sl0 28800 |
| 149 | 137 | eql_enslave eql ppp0 14400 |
| 150 | 138 | eql_enslave eql sl1 57600 |
| 151 | − ______________________________________________________________________ | |
| 152 | − | |
| 153 | − | |
| 154 | − | |
| 155 | − | |
| 156 | 139 | |
| 157 | 140 | When you want to free a device from its life of slavery, you can |
| 158 | 141 | either down the device with ifconfig (eql will automatically bury the |
| 159 | 142 | dead slave and remove it from its queue) or use eql_emancipate to free |
| 160 | 143 | it. (-- Or just ifconfig it down, and the eql driver will take it out |
| 161 | − for you.--) | |
| 162 | − | |
| 163 | − | |
| 144 | + for you.--):: | |
| 164 | 145 | |
| 165 | − ______________________________________________________________________ | |
| 166 | 146 | eql_emancipate eql sl0 |
| 167 | 147 | eql_emancipate eql ppp0 |
| 168 | 148 | eql_emancipate eql sl1 |
| 169 | − ______________________________________________________________________ | |
| 170 | 149 | |
| 171 | 150 | |
| 172 | − | |
| 173 | − | |
| 174 | − | |
| 175 | − 3.3. DSLIP Configuration for the eql Device | |
| 151 | +3.3. DSLIP Configuration for the eql Device | |
| 152 | +------------------------------------------- | |
| 176 | 153 | |
| 177 | 154 | The general idea is to bring up and keep up as many SLIP connections |
| 178 | 155 | as you need, automatically. |
| 179 | 156 | |
| 180 | 157 | |
| 181 | − 3.3.1. /etc/slip/runslip.conf | |
| 182 | − | |
| 183 | − Here is an example runslip.conf: | |
| 184 | − | |
| 185 | − | |
| 186 | − | |
| 187 | − | |
| 188 | − | |
| 189 | − | |
| 190 | − | |
| 191 | − | |
| 192 | − | |
| 193 | − | |
| 194 | − | |
| 158 | +3.3.1. /etc/slip/runslip.conf | |
| 159 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | |
| 195 | 160 | |
| 161 | + Here is an example runslip.conf:: | |
| 196 | 162 | |
| 163 | + name sl-line-1 | |
| 164 | + enabled | |
| 165 | + baud 38400 | |
| 166 | + mtu 576 | |
| 167 | + ducmd -e /etc/slip/dialout/cua2-288.xp -t 9 | |
| 168 | + command eql_enslave eql $interface 28800 | |
| 169 | + address 198.67.33.239 | |
| 170 | + line /dev/cua2 | |
| 197 | 171 | |
| 172 | + name sl-line-2 | |
| 173 | + enabled | |
| 174 | + baud 38400 | |
| 175 | + mtu 576 | |
| 176 | + ducmd -e /etc/slip/dialout/cua3-288.xp -t 9 | |
| 177 | + command eql_enslave eql $interface 28800 | |
| 178 | + address 198.67.33.239 | |
| 179 | + line /dev/cua3 | |
| 198 | 180 | |
| 199 | − ______________________________________________________________________ | |
| 200 | − name sl-line-1 | |
| 201 | − enabled | |
| 202 | − baud 38400 | |
| 203 | − mtu 576 | |
| 204 | − ducmd -e /etc/slip/dialout/cua2-288.xp -t 9 | |
| 205 | − command eql_enslave eql $interface 28800 | |
| 206 | − address 198.67.33.239 | |
| 207 | − line /dev/cua2 | |
| 208 | 181 | |
| 209 | − name sl-line-2 | |
| 210 | − enabled | |
| 211 | − baud 38400 | |
| 212 | − mtu 576 | |
| 213 | − ducmd -e /etc/slip/dialout/cua3-288.xp -t 9 | |
| 214 | − command eql_enslave eql $interface 28800 | |
| 215 | − address 198.67.33.239 | |
| 216 | − line /dev/cua3 | |
| 217 | − ______________________________________________________________________ | |
359 more lines aren’t shown here.
This diff is large: its 250 lines aren’t shown here.
This diff is large: its 44 lines aren’t shown here.
This diff is large: its 1501 lines aren’t shown here.
This diff is large: its 21 lines aren’t shown here.
This diff is large: its 46 lines aren’t shown here.
This diff is large: its 155 lines aren’t shown here.
This diff is large: its 171 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 199 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 173 lines aren’t shown here.
This diff is large: its 108 lines aren’t shown here.
This diff is large: its 2048 lines aren’t shown here.
This diff is large: its 50 lines aren’t shown here.
This diff is large: its 25 lines aren’t shown here.
This diff is large: its 268 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 238 lines aren’t shown here.
This diff is large: its 275 lines aren’t shown here.
This diff is large: its 190 lines aren’t shown here.
This diff is large: its 217 lines aren’t shown here.
This diff is large: its 295 lines aren’t shown here.
This diff is large: its 130 lines aren’t shown here.
This diff is large: its 104 lines aren’t shown here.
This diff is large: its 47 lines aren’t shown here.
This diff is large: its 82 lines aren’t shown here.
This diff is large: its 235 lines aren’t shown here.
This diff is large: its 51 lines aren’t shown here.
This diff is large: its 43 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 96 lines aren’t shown here.
This diff is large: its 80 lines aren’t shown here.
This diff is large: its 105 lines aren’t shown here.
This diff is large: its 90 lines aren’t shown here.
This diff is large: its 83 lines aren’t shown here.
This diff is large: its 123 lines aren’t shown here.
This diff is large: its 1085 lines aren’t shown here.
This diff is large: its 1062 lines aren’t shown here.
This diff is large: its 140 lines aren’t shown here.
This diff is large: its 491 lines aren’t shown here.
This diff is large: its 114 lines aren’t shown here.
This diff is large: its 155 lines aren’t shown here.
This diff is large: its 58 lines aren’t shown here.
This diff is large: its 146 lines aren’t shown here.
This diff is large: its 178 lines aren’t shown here.
This diff is large: its 411 lines aren’t shown here.
This diff is large: its 85 lines aren’t shown here.
This diff is large: its 954 lines aren’t shown here.
This diff is large: its 58 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 308 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 188 lines aren’t shown here.
This diff is large: its 208 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 25 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 397 lines aren’t shown here.
This diff is large: its 97 lines aren’t shown here.
This diff is large: its 318 lines aren’t shown here.
This diff is large: its 305 lines aren’t shown here.
This diff is large: its 452 lines aren’t shown here.
This diff is large: its 419 lines aren’t shown here.
This diff is large: its 55 lines aren’t shown here.
This diff is large: its 21 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 111 lines aren’t shown here.
This diff is large: its 107 lines aren’t shown here.
This diff is large: its 147 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 882 lines aren’t shown here.
This diff is large: its 7 lines aren’t shown here.
This diff is large: its 256 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 34 lines aren’t shown here.
This diff is large: its 44 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 53 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 29 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 169 lines aren’t shown here.
This diff is large: its 115 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 47 lines aren’t shown here.
This diff is large: its 94 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 35 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 48 lines aren’t shown here.
This diff is large: its 21 lines aren’t shown here.
This diff is large: its 239 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 52 lines aren’t shown here.
This diff is large: its 91 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 29 lines aren’t shown here.
This diff is large: its 323 lines aren’t shown here.
This diff is large: its 91 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 382 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 268 lines aren’t shown here.
This diff is large: its 57 lines aren’t shown here.
This diff is large: its 26 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 205 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 331 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 42 lines aren’t shown here.
This diff is large: its 33 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 50 lines aren’t shown here.
This diff is large: its 38 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 285 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 294 lines aren’t shown here.
This diff is large: its 47 lines aren’t shown here.
This diff is large: its 591 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 83 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 54 lines aren’t shown here.
This diff is large: its 33 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 100 lines aren’t shown here.
This diff is large: its 503 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 282 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 53 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 39 lines aren’t shown here.
This diff is large: its 85 lines aren’t shown here.
This diff is large: its 14 lines aren’t shown here.
This diff is large: its 177 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 242 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 207 lines aren’t shown here.
This diff is large: its 113 lines aren’t shown here.
This diff is large: its 304 lines aren’t shown here.
This diff is large: its 167 lines aren’t shown here.
This diff is large: its 313 lines aren’t shown here.
This diff is large: its 1504 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 92 lines aren’t shown here.
This diff is large: its 473 lines aren’t shown here.
This diff is large: its 220 lines aren’t shown here.
This diff is large: its 199 lines aren’t shown here.
This diff is large: its 66 lines aren’t shown here.
This diff is large: its 783 lines aren’t shown here.
This diff is large: its 75 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 692 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 14 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 58 lines aren’t shown here.
This diff is large: its 320 lines aren’t shown here.
This diff is large: its 218 lines aren’t shown here.
This diff is large: its 6 lines aren’t shown here.
This diff is large: its 49 lines aren’t shown here.
This diff is large: its 35 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 191 lines aren’t shown here.
This diff is large: its 263 lines aren’t shown here.
This diff is large: its 59 lines aren’t shown here.
This diff is large: its 6 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 56 lines aren’t shown here.
This diff is large: its 171 lines aren’t shown here.
This diff is large: its 44 lines aren’t shown here.
This diff is large: its 117 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 105 lines aren’t shown here.
This diff is large: its 640 lines aren’t shown here.
This diff is large: its 62 lines aren’t shown here.
This diff is large: its 123 lines aren’t shown here.
This diff is large: its 52 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 147 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 91 lines aren’t shown here.
This diff is large: its 621 lines aren’t shown here.
This diff is large: its 54 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 160 lines aren’t shown here.
This diff is large: its 86 lines aren’t shown here.
This diff is large: its 122 lines aren’t shown here.
This diff is large: its 142 lines aren’t shown here.
This diff is large: its 66 lines aren’t shown here.
This diff is large: its 75 lines aren’t shown here.
This diff is large: its 842 lines aren’t shown here.
This diff is large: its 15 lines aren’t shown here.
This diff is large: its 128 lines aren’t shown here.
This diff is large: its 235 lines aren’t shown here.
This diff is large: its 103 lines aren’t shown here.
This diff is large: its 392 lines aren’t shown here.
This diff is large: its 132 lines aren’t shown here.
This diff is large: its 607 lines aren’t shown here.
This diff is large: its 321 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 66 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 57 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 221 lines aren’t shown here.
This diff is large: its 67 lines aren’t shown here.
This diff is large: its 415 lines aren’t shown here.
This diff is large: its 15 lines aren’t shown here.
This diff is large: its 396 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 83 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 15 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 979 lines aren’t shown here.
This diff is large: its 71 lines aren’t shown here.
This diff is large: its 175 lines aren’t shown here.
This diff is large: its 21 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 93 lines aren’t shown here.
This diff is large: its 286 lines aren’t shown here.
This diff is large: its 145 lines aren’t shown here.
This diff is large: its 80 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 260 lines aren’t shown here.
This diff is large: its 57 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 104 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 36 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 151 lines aren’t shown here.
This diff is large: its 46 lines aren’t shown here.
This diff is large: its 800 lines aren’t shown here.
This diff is large: its 172 lines aren’t shown here.
This diff is large: its 54 lines aren’t shown here.
This diff is large: its 71 lines aren’t shown here.
This diff is large: its 188 lines aren’t shown here.
This diff is large: its 125 lines aren’t shown here.
This diff is large: its 63 lines aren’t shown here.
This diff is large: its 123 lines aren’t shown here.
This diff is large: its 198 lines aren’t shown here.
This diff is large: its 115 lines aren’t shown here.
This diff is large: its 1114 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 320 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 102 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 300 lines aren’t shown here.
This diff is large: its 101 lines aren’t shown here.
This diff is large: its 138 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 86 lines aren’t shown here.
This diff is large: its 267 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 2448 lines aren’t shown here.
This diff is large: its 108 lines aren’t shown here.
This diff is large: its 163 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 88 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 569 lines aren’t shown here.
This diff is large: its 74 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 88 lines aren’t shown here.
This diff is large: its 6 lines aren’t shown here.
This diff is large: its 33 lines aren’t shown here.
This diff is large: its 609 lines aren’t shown here.
This diff is large: its 98 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 445 lines aren’t shown here.
This diff is large: its 170 lines aren’t shown here.
This diff is large: its 173 lines aren’t shown here.
This diff is large: its 29 lines aren’t shown here.
This diff is large: its 158 lines aren’t shown here.
This diff is large: its 91 lines aren’t shown here.
This diff is large: its 116 lines aren’t shown here.
This diff is large: its 56 lines aren’t shown here.
This diff is large: its 1211 lines aren’t shown here.
This diff is large: its 155 lines aren’t shown here.
This diff is large: its 45 lines aren’t shown here.
This diff is large: its 34 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 322 lines aren’t shown here.
This diff is large: its 410 lines aren’t shown here.
This diff is large: its 193 lines aren’t shown here.
This diff is large: its 29 lines aren’t shown here.
This diff is large: its 1295 lines aren’t shown here.
This diff is large: its 110 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 53 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 189 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 21 lines aren’t shown here.
This diff is large: its 105 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 355 lines aren’t shown here.
This diff is large: its 45 lines aren’t shown here.
This diff is large: its 55 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 553 lines aren’t shown here.
This diff is large: its 15 lines aren’t shown here.
This diff is large: its 15 lines aren’t shown here.
This diff is large: its 182 lines aren’t shown here.
This diff is large: its 164 lines aren’t shown here.
This diff is large: its 664 lines aren’t shown here.
This diff is large: its 83 lines aren’t shown here.
This diff is large: its 290 lines aren’t shown here.
This diff is large: its 260 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 282 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 144 lines aren’t shown here.
This diff is large: its 52 lines aren’t shown here.
This diff is large: its 46 lines aren’t shown here.
This diff is large: its 37 lines aren’t shown here.
This diff is large: its 346 lines aren’t shown here.
This diff is large: its 1698 lines aren’t shown here.
This diff is large: its 841 lines aren’t shown here.
This diff is large: its 167 lines aren’t shown here.
This diff is large: its 1079 lines aren’t shown here.
This diff is large: its 15 lines aren’t shown here.
This diff is large: its 77 lines aren’t shown here.
This diff is large: its 482 lines aren’t shown here.
This diff is large: its 90 lines aren’t shown here.
This diff is large: its 398 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 85 lines aren’t shown here.
This diff is large: its 176 lines aren’t shown here.
This diff is large: its 1126 lines aren’t shown here.
This diff is large: its 42 lines aren’t shown here.
This diff is large: its 1344 lines aren’t shown here.
This diff is large: its 119 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 49 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 146 lines aren’t shown here.
This diff is large: its 14 lines aren’t shown here.
This diff is large: its 598 lines aren’t shown here.
This diff is large: its 72 lines aren’t shown here.
This diff is large: its 90 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 168 lines aren’t shown here.
This diff is large: its 1778 lines aren’t shown here.
This diff is large: its 52 lines aren’t shown here.
This diff is large: its 555 lines aren’t shown here.
This diff is large: its 37 lines aren’t shown here.
This diff is large: its 38 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 6 lines aren’t shown here.
This diff is large: its 536 lines aren’t shown here.
This diff is large: its 37 lines aren’t shown here.
This diff is large: its 138 lines aren’t shown here.
This diff is large: its 187 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 212 lines aren’t shown here.
This diff is large: its 1189 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 39 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 1522 lines aren’t shown here.
This diff is large: its 81 lines aren’t shown here.
This diff is large: its 122 lines aren’t shown here.
This diff is large: its 158 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 150 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 485 lines aren’t shown here.
This diff is large: its 62 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 84 lines aren’t shown here.
This diff is large: its 107 lines aren’t shown here.
This diff is large: its 38 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 1652 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 34 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 58 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 26 lines aren’t shown here.
This diff is large: its 38 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 76 lines aren’t shown here.
This diff is large: its 84 lines aren’t shown here.
This diff is large: its 172 lines aren’t shown here.
This diff is large: its 102 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 50 lines aren’t shown here.
This diff is large: its 212 lines aren’t shown here.
This diff is large: its 55 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 91 lines aren’t shown here.
This diff is large: its 23 lines aren’t shown here.
This diff is large: its 351 lines aren’t shown here.
This diff is large: its 369 lines aren’t shown here.
This diff is large: its 35 lines aren’t shown here.
This diff is large: its 647 lines aren’t shown here.
This diff is large: its 78 lines aren’t shown here.
This diff is large: its 474 lines aren’t shown here.
This diff is large: its 75 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 135 lines aren’t shown here.
This diff is large: its 201 lines aren’t shown here.
This diff is large: its 200 lines aren’t shown here.
This diff is large: its 65 lines aren’t shown here.
This diff is large: its 176 lines aren’t shown here.
This diff is large: its 42 lines aren’t shown here.
This diff is large: its 25 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 89 lines aren’t shown here.
This diff is large: its 75 lines aren’t shown here.
This diff is large: its 159 lines aren’t shown here.
This diff is large: its 39 lines aren’t shown here.
This diff is large: its 44 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 120 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 63 lines aren’t shown here.
This diff is large: its 179 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 21 lines aren’t shown here.
This diff is large: its 125 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 53 lines aren’t shown here.
This diff is large: its 65 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 624 lines aren’t shown here.
This diff is large: its 1070 lines aren’t shown here.
This diff is large: its 83 lines aren’t shown here.
This diff is large: its 288 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 139 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 1044 lines aren’t shown here.
This diff is large: its 102 lines aren’t shown here.
This diff is large: its 147 lines aren’t shown here.
This diff is large: its 14 lines aren’t shown here.
This diff is large: its 23 lines aren’t shown here.
This diff is large: its 171 lines aren’t shown here.
This diff is large: its 236 lines aren’t shown here.
This diff is large: its 161 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 280 lines aren’t shown here.
This diff is large: its 323 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 741 lines aren’t shown here.
This diff is large: its 107 lines aren’t shown here.
This diff is large: its 539 lines aren’t shown here.
This diff is large: its 96 lines aren’t shown here.
This diff is large: its 259 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 101 lines aren’t shown here.
This diff is large: its 37 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 308 lines aren’t shown here.
This diff is large: its 216 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 105 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 302 lines aren’t shown here.
This diff is large: its 53 lines aren’t shown here.
This diff is large: its 71 lines aren’t shown here.
This diff is large: its 286 lines aren’t shown here.
This diff is large: its 35 lines aren’t shown here.
This diff is large: its 37 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 29 lines aren’t shown here.
This diff is large: its 445 lines aren’t shown here.
This diff is large: its 39 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 73 lines aren’t shown here.
This diff is large: its 229 lines aren’t shown here.
This diff is large: its 35 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 82 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 153 lines aren’t shown here.
This diff is large: its 48 lines aren’t shown here.
This diff is large: its 103 lines aren’t shown here.
This diff is large: its 42 lines aren’t shown here.
This diff is large: its 89 lines aren’t shown here.
This diff is large: its 195 lines aren’t shown here.
This diff is large: its 26 lines aren’t shown here.
This diff is large: its 54 lines aren’t shown here.
This diff is large: its 72 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 297 lines aren’t shown here.
This diff is large: its 36 lines aren’t shown here.
This diff is large: its 423 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 61 lines aren’t shown here.
This diff is large: its 751 lines aren’t shown here.
This diff is large: its 274 lines aren’t shown here.
This diff is large: its 56 lines aren’t shown here.
This diff is large: its 357 lines aren’t shown here.
This diff is large: its 48 lines aren’t shown here.
This diff is large: its 107 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 306 lines aren’t shown here.
This diff is large: its 187 lines aren’t shown here.
This diff is large: its 379 lines aren’t shown here.
This diff is large: its 48 lines aren’t shown here.
This diff is large: its 837 lines aren’t shown here.
This diff is large: its 97 lines aren’t shown here.
This diff is large: its 1556 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 169 lines aren’t shown here.
This diff is large: its 1143 lines aren’t shown here.
This diff is large: its 1394 lines aren’t shown here.
This diff is large: its 358 lines aren’t shown here.
This diff is large: its 486 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 34 lines aren’t shown here.
This diff is large: its 14 lines aren’t shown here.
This diff is large: its 124 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 14 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 7 lines aren’t shown here.
This diff is large: its 278 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 126 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 58 lines aren’t shown here.
This diff is large: its 102 lines aren’t shown here.
This diff is large: its 325 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 180 lines aren’t shown here.
This diff is large: its 62 lines aren’t shown here.
This diff is large: its 73 lines aren’t shown here.
This diff is large: its 56 lines aren’t shown here.
This diff is large: its 21 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 56 lines aren’t shown here.
This diff is large: its 79 lines aren’t shown here.
This diff is large: its 1997 lines aren’t shown here.
This diff is large: its 353 lines aren’t shown here.
This diff is large: its 83 lines aren’t shown here.
This diff is large: its 35 lines aren’t shown here.
This diff is large: its 217 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 129 lines aren’t shown here.
This diff is large: its 53 lines aren’t shown here.
This diff is large: its 131 lines aren’t shown here.
This diff is large: its 36 lines aren’t shown here.
This diff is large: its 110 lines aren’t shown here.
This diff is large: its 49 lines aren’t shown here.
This diff is large: its 96 lines aren’t shown here.
This diff is large: its 56 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 78 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 78 lines aren’t shown here.
This diff is large: its 278 lines aren’t shown here.
This diff is large: its 49 lines aren’t shown here.
This diff is large: its 304 lines aren’t shown here.
This diff is large: its 72 lines aren’t shown here.
This diff is large: its 133 lines aren’t shown here.
This diff is large: its 23 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 55 lines aren’t shown here.
This diff is large: its 54 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 352 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 71 lines aren’t shown here.
This diff is large: its 64 lines aren’t shown here.
This diff is large: its 2088 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 14 lines aren’t shown here.
This diff is large: its 378 lines aren’t shown here.
This diff is large: its 76 lines aren’t shown here.
This diff is large: its 33 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 283 lines aren’t shown here.
This diff is large: its 38 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 14 lines aren’t shown here.
This diff is large: its 51 lines aren’t shown here.
This diff is large: its 52 lines aren’t shown here.
This diff is large: its 14 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 97 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 316 lines aren’t shown here.
This diff is large: its 351 lines aren’t shown here.
This diff is large: its 216 lines aren’t shown here.
This diff is large: its 156 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 105 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 35 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 46 lines aren’t shown here.
This diff is large: its 7 lines aren’t shown here.
This diff is large: its 65 lines aren’t shown here.
This diff is large: its 332 lines aren’t shown here.
This diff is large: its 44 lines aren’t shown here.
This diff is large: its 627 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 1087 lines aren’t shown here.
This diff is large: its 75 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 43 lines aren’t shown here.
This diff is large: its 60 lines aren’t shown here.
This diff is large: its 47 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 647 lines aren’t shown here.
This diff is large: its 77 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 25 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 63 lines aren’t shown here.
This diff is large: its 34 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 341 lines aren’t shown here.
This diff is large: its 47 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 80 lines aren’t shown here.
This diff is large: its 25 lines aren’t shown here.
This diff is large: its 32 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 58 lines aren’t shown here.
This diff is large: its 329 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 29 lines aren’t shown here.
This diff is large: its 256 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 45 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 38 lines aren’t shown here.
This diff is large: its 42 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 392 lines aren’t shown here.
This diff is large: its 390 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 861 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 120 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 73 lines aren’t shown here.
This diff is large: its 575 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 161 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 67 lines aren’t shown here.
This diff is large: its 70 lines aren’t shown here.
This diff is large: its 184 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 229 lines aren’t shown here.
This diff is large: its 548 lines aren’t shown here.
This diff is large: its 7 lines aren’t shown here.
This diff is large: its 25 lines aren’t shown here.
This diff is large: its 301 lines aren’t shown here.
This diff is large: its 379 lines aren’t shown here.
This diff is large: its 138 lines aren’t shown here.
This diff is large: its 43 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 54 lines aren’t shown here.
This diff is large: its 107 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 29 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 118 lines aren’t shown here.
This diff is large: its 77 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 102 lines aren’t shown here.
This diff is large: its 315 lines aren’t shown here.
This diff is large: its 336 lines aren’t shown here.
This diff is large: its 78 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 707 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 23 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 92 lines aren’t shown here.
This diff is large: its 86 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 42 lines aren’t shown here.
This diff is large: its 483 lines aren’t shown here.
This diff is large: its 93 lines aren’t shown here.
This diff is large: its 41 lines aren’t shown here.
This diff is large: its 246 lines aren’t shown here.
This diff is large: its 71 lines aren’t shown here.
This diff is large: its 91 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 457 lines aren’t shown here.
This diff is large: its 212 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 129 lines aren’t shown here.
This diff is large: its 38 lines aren’t shown here.
This diff is large: its 342 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 254 lines aren’t shown here.
This diff is large: its 14 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 26 lines aren’t shown here.
This diff is large: its 68 lines aren’t shown here.
This diff is large: its 215 lines aren’t shown here.
This diff is large: its 172 lines aren’t shown here.
This diff is large: its 107 lines aren’t shown here.
This diff is large: its 242 lines aren’t shown here.
This diff is large: its 166 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 136 lines aren’t shown here.
This diff is large: its 70 lines aren’t shown here.
This diff is large: its 37 lines aren’t shown here.
This diff is large: its 59 lines aren’t shown here.
This diff is large: its 94 lines aren’t shown here.
This diff is large: its 36 lines aren’t shown here.
This diff is large: its 330 lines aren’t shown here.
This diff is large: its 29 lines aren’t shown here.
This diff is large: its 42 lines aren’t shown here.
This diff is large: its 188 lines aren’t shown here.
This diff is large: its 142 lines aren’t shown here.
This diff is large: its 292 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 59 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 45 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 66 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 21 lines aren’t shown here.
This diff is large: its 240 lines aren’t shown here.
This diff is large: its 63 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 38 lines aren’t shown here.
This diff is large: its 219 lines aren’t shown here.
This diff is large: its 137 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 43 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 99 lines aren’t shown here.
This diff is large: its 32 lines aren’t shown here.
This diff is large: its 178 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 41 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 23 lines aren’t shown here.
This diff is large: its 34 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 35 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 72 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 261 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 50 lines aren’t shown here.
This diff is large: its 430 lines aren’t shown here.
This diff is large: its 69 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 26 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 50 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 295 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 121 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 29 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 33 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 92 lines aren’t shown here.
This diff is large: its 54 lines aren’t shown here.
This diff is large: its 126 lines aren’t shown here.
This diff is large: its 99 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 351 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 33 lines aren’t shown here.
This diff is large: its 25 lines aren’t shown here.
This diff is large: its 216 lines aren’t shown here.
This diff is large: its 93 lines aren’t shown here.
This diff is large: its 69 lines aren’t shown here.
This diff is large: its 53 lines aren’t shown here.
This diff is large: its 26 lines aren’t shown here.
This diff is large: its 46 lines aren’t shown here.
This diff is large: its 196 lines aren’t shown here.
This diff is large: its 81 lines aren’t shown here.
This diff is large: its 48 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 37 lines aren’t shown here.
This diff is large: its 33 lines aren’t shown here.
This diff is large: its 395 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 141 lines aren’t shown here.
This diff is large: its 34 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 100 lines aren’t shown here.
This diff is large: its 25 lines aren’t shown here.
This diff is large: its 80 lines aren’t shown here.
This diff is large: its 61 lines aren’t shown here.
This diff is large: its 46 lines aren’t shown here.
This diff is large: its 124 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 70 lines aren’t shown here.
This diff is large: its 64 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 43 lines aren’t shown here.
This diff is large: its 36 lines aren’t shown here.
This diff is large: its 34 lines aren’t shown here.
This diff is large: its 149 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 144 lines aren’t shown here.
This diff is large: its 36 lines aren’t shown here.
This diff is large: its 175 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 247 lines aren’t shown here.
This diff is large: its 118 lines aren’t shown here.
This diff is large: its 48 lines aren’t shown here.
This diff is large: its 98 lines aren’t shown here.
This diff is large: its 23 lines aren’t shown here.
This diff is large: its 36 lines aren’t shown here.
This diff is large: its 79 lines aren’t shown here.
This diff is large: its 129 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 32 lines aren’t shown here.
This diff is large: its 68 lines aren’t shown here.
This diff is large: its 101 lines aren’t shown here.
This diff is large: its 49 lines aren’t shown here.
This diff is large: its 274 lines aren’t shown here.
This diff is large: its 208 lines aren’t shown here.
This diff is large: its 86 lines aren’t shown here.
This diff is large: its 39 lines aren’t shown here.
This diff is large: its 334 lines aren’t shown here.
This diff is large: its 356 lines aren’t shown here.
This diff is large: its 480 lines aren’t shown here.
This diff is large: its 36 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 14 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 33 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 148 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 21 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 14 lines aren’t shown here.
This diff is large: its 72 lines aren’t shown here.
This diff is large: its 50 lines aren’t shown here.
This diff is large: its 29 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 60 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 5 lines aren’t shown here.
This diff is large: its 7 lines aren’t shown here.
This diff is large: its 44 lines aren’t shown here.
This diff is large: its 35 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 116 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 200 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 77 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 102 lines aren’t shown here.
This diff is large: its 131 lines aren’t shown here.
This diff is large: its 198 lines aren’t shown here.
This diff is large: its 63 lines aren’t shown here.
This diff is large: its 452 lines aren’t shown here.
This diff is large: its 1239 lines aren’t shown here.
This diff is large: its 67 lines aren’t shown here.
This diff is large: its 552 lines aren’t shown here.
This diff is large: its 2147 lines aren’t shown here.
This diff is large: its 365 lines aren’t shown here.
This diff is large: its 158 lines aren’t shown here.
This diff is large: its 365 lines aren’t shown here.
This diff is large: its 172 lines aren’t shown here.
This diff is large: its 175 lines aren’t shown here.
This diff is large: its 185 lines aren’t shown here.
This diff is large: its 232 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 448 lines aren’t shown here.
This diff is large: its 146 lines aren’t shown here.
This diff is large: its 94 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 34 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 52 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 26 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 82 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 14 lines aren’t shown here.
This diff is large: its 7 lines aren’t shown here.
This diff is large: its 464 lines aren’t shown here.
This diff is large: its 286 lines aren’t shown here.
This diff is large: its 244 lines aren’t shown here.
This diff is large: its 126 lines aren’t shown here.
This diff is large: its 703 lines aren’t shown here.
This diff is large: its 1478 lines aren’t shown here.
This diff is large: its 347 lines aren’t shown here.
This diff is large: its 839 lines aren’t shown here.
This diff is large: its 3183 lines aren’t shown here.
This diff is large: its 1035 lines aren’t shown here.
This diff is large: its 470 lines aren’t shown here.
This diff is large: its 192 lines aren’t shown here.
This diff is large: its 376 lines aren’t shown here.
This diff is large: its 21 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 38 lines aren’t shown here.
This diff is large: its 32 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 107 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 243 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 21 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 36 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 51 lines aren’t shown here.
This diff is large: its 39 lines aren’t shown here.
This diff is large: its 88 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 60 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 50 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 155 lines aren’t shown here.
This diff is large: its 48 lines aren’t shown here.
This diff is large: its 582 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 83 lines aren’t shown here.
This diff is large: its 179 lines aren’t shown here.
This diff is large: its 269 lines aren’t shown here.
This diff is large: its 159 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 312 lines aren’t shown here.
This diff is large: its 26 lines aren’t shown here.
This diff is large: its 293 lines aren’t shown here.
This diff is large: its 2754 lines aren’t shown here.
This diff is large: its 284 lines aren’t shown here.
This diff is large: its 1197 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 15 lines aren’t shown here.
This diff is large: its 129 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 15 lines aren’t shown here.
This diff is large: its 286 lines aren’t shown here.
This diff is large: its 33 lines aren’t shown here.
This diff is large: its 21342 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 15 lines aren’t shown here.
This diff is large: its 5 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 25 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 47 lines aren’t shown here.
This diff is large: its 88 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 23 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 139 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 78 lines aren’t shown here.
This diff is large: its 85 lines aren’t shown here.
This diff is large: its 103 lines aren’t shown here.
This diff is large: its 105 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 150 lines aren’t shown here.
This diff is large: its 29 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 54 lines aren’t shown here.
This diff is large: its 73 lines aren’t shown here.
This diff is large: its 146 lines aren’t shown here.
This diff is large: its 123 lines aren’t shown here.
This diff is large: its 718 lines aren’t shown here.
This diff is large: its 39 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 41 lines aren’t shown here.
This diff is large: its 102 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 34 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 38 lines aren’t shown here.
This diff is large: its 59 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 44 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 56 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 29 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 292 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 63 lines aren’t shown here.
This diff is large: its 26 lines aren’t shown here.
This diff is large: its 71 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 91 lines aren’t shown here.
This diff is large: its 65 lines aren’t shown here.
This diff is large: its 289 lines aren’t shown here.
This diff is large: its 15 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 85 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 101 lines aren’t shown here.
This diff is large: its 23 lines aren’t shown here.
This diff is large: its 26 lines aren’t shown here.
This diff is large: its 59 lines aren’t shown here.
This diff is large: its 7 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 15 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 563 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 21 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 76 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 45 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 52 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 118 lines aren’t shown here.
This diff is large: its 105 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 639 lines aren’t shown here.
This diff is large: its 87 lines aren’t shown here.
This diff is large: its 34 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 34 lines aren’t shown here.
This diff is large: its 38 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 191 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 25 lines aren’t shown here.
This diff is large: its 21 lines aren’t shown here.
This diff is large: its 340 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 48 lines aren’t shown here.
This diff is large: its 63 lines aren’t shown here.
This diff is large: its 68 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 57 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 82 lines aren’t shown here.
This diff is large: its 32 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 36 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 7 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 79 lines aren’t shown here.
This diff is large: its 98 lines aren’t shown here.
This diff is large: its 25 lines aren’t shown here.
This diff is large: its 218 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 64 lines aren’t shown here.
This diff is large: its 600 lines aren’t shown here.
This diff is large: its 60 lines aren’t shown here.
This diff is large: its 224 lines aren’t shown here.
This diff is large: its 56 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 45 lines aren’t shown here.
This diff is large: its 114 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 15 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 127 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 200 lines aren’t shown here.
This diff is large: its 29 lines aren’t shown here.
This diff is large: its 59 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 36 lines aren’t shown here.
This diff is large: its 241 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 7 lines aren’t shown here.
This diff is large: its 91 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 14 lines aren’t shown here.
This diff is large: its 23 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 91 lines aren’t shown here.
This diff is large: its 147 lines aren’t shown here.
This diff is large: its 68 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 37 lines aren’t shown here.
This diff is large: its 130 lines aren’t shown here.
This diff is large: its 340 lines aren’t shown here.
This diff is large: its 233 lines aren’t shown here.
This diff is large: its 88 lines aren’t shown here.
This diff is large: its 141 lines aren’t shown here.
This diff is large: its 50 lines aren’t shown here.
This diff is large: its 38 lines aren’t shown here.
This diff is large: its 89 lines aren’t shown here.
This diff is large: its 116 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 675 lines aren’t shown here.
This diff is large: its 48 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 186 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 110 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 14 lines aren’t shown here.
This diff is large: its 123 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 21 lines aren’t shown here.
This diff is large: its 108 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 346 lines aren’t shown here.
This diff is large: its 45 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 36 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 48 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 45 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 45 lines aren’t shown here.
This diff is large: its 540 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 92 lines aren’t shown here.
This diff is large: its 283 lines aren’t shown here.
This diff is large: its 38 lines aren’t shown here.
This diff is large: its 47 lines aren’t shown here.
This diff is large: its 283 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 136 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 103 lines aren’t shown here.
This diff is large: its 374 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 502 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 1006 lines aren’t shown here.
This diff is large: its 354 lines aren’t shown here.
This diff is large: its 883 lines aren’t shown here.
This diff is large: its 34 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 4310 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 318 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 54 lines aren’t shown here.
This diff is large: its 402 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 37 lines aren’t shown here.
This diff is large: its 51 lines aren’t shown here.
This diff is large: its 93 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 50 lines aren’t shown here.
This diff is large: its 26 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 119 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 129 lines aren’t shown here.
This diff is large: its 123 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 31 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 52 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 7 lines aren’t shown here.
This diff is large: its 48 lines aren’t shown here.
This diff is large: its 226 lines aren’t shown here.
This diff is large: its 60 lines aren’t shown here.
This diff is large: its 216 lines aren’t shown here.
This diff is large: its 72 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 260 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 1213 lines aren’t shown here.
This diff is large: its 142 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 117 lines aren’t shown here.
This diff is large: its 67 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 6 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 59 lines aren’t shown here.
This diff is large: its 51 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 678 lines aren’t shown here.
This diff is large: its 328 lines aren’t shown here.
This diff is large: its 144 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 91 lines aren’t shown here.
This diff is large: its 67 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 36 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 249 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 291 lines aren’t shown here.
This diff is large: its 352 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 786 lines aren’t shown here.
This diff is large: its 271 lines aren’t shown here.
This diff is large: its 370 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 37 lines aren’t shown here.
This diff is large: its 100 lines aren’t shown here.
This diff is large: its 95 lines aren’t shown here.
This diff is large: its 70 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 198 lines aren’t shown here.
This diff is large: its 52 lines aren’t shown here.
This diff is large: its 131 lines aren’t shown here.
This diff is large: its 293 lines aren’t shown here.
This diff is large: its 32 lines aren’t shown here.
This diff is large: its 121 lines aren’t shown here.
This diff is large: its 133 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 15 lines aren’t shown here.
This diff is large: its 21 lines aren’t shown here.
This diff is large: its 69 lines aren’t shown here.
This diff is large: its 96 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 25 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 33 lines aren’t shown here.
This diff is large: its 79 lines aren’t shown here.
This diff is large: its 183 lines aren’t shown here.
This diff is large: its 41 lines aren’t shown here.
This diff is large: its 325 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 116 lines aren’t shown here.
This diff is large: its 35 lines aren’t shown here.
This diff is large: its 6 lines aren’t shown here.
This diff is large: its 432 lines aren’t shown here.
This diff is large: its 55 lines aren’t shown here.
This diff is large: its 92 lines aren’t shown here.
This diff is large: its 110 lines aren’t shown here.
This diff is large: its 120 lines aren’t shown here.
This diff is large: its 33 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 15 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 42 lines aren’t shown here.
This diff is large: its 33 lines aren’t shown here.
This diff is large: its 22 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 157 lines aren’t shown here.
This diff is large: its 60 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 53 lines aren’t shown here.
This diff is large: its 13 lines aren’t shown here.
This diff is large: its 81 lines aren’t shown here.
This diff is large: its 189 lines aren’t shown here.
This diff is large: its 488 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 63 lines aren’t shown here.
This diff is large: its 51 lines aren’t shown here.
This diff is large: its 148 lines aren’t shown here.
This diff is large: its 391 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 159 lines aren’t shown here.
This diff is large: its 264 lines aren’t shown here.
This diff is large: its 185 lines aren’t shown here.
This diff is large: its 164 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 96 lines aren’t shown here.
This diff is large: its 16 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 80 lines aren’t shown here.
This diff is large: its 37 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 489 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 215 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 624 lines aren’t shown here.
This diff is large: its 25 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 81 lines aren’t shown here.
This diff is large: its 389 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 60 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 389 lines aren’t shown here.
This diff is large: its 57 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 207 lines aren’t shown here.
This diff is large: its 435 lines aren’t shown here.
This diff is large: its 10 lines aren’t shown here.
This diff is large: its 33 lines aren’t shown here.
This diff is large: its 152 lines aren’t shown here.
This diff is large: its 137 lines aren’t shown here.
This diff is large: its 126 lines aren’t shown here.
This diff is large: its 62 lines aren’t shown here.
This diff is large: its 38 lines aren’t shown here.
This diff is large: its 351 lines aren’t shown here.
This diff is large: its 212 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 131 lines aren’t shown here.
This diff is large: its 204 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 15 lines aren’t shown here.
This diff is large: its 86 lines aren’t shown here.
This diff is large: its 55 lines aren’t shown here.
This diff is large: its 135 lines aren’t shown here.
This diff is large: its 12 lines aren’t shown here.
This diff is large: its 40 lines aren’t shown here.
This diff is large: its 160 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 30 lines aren’t shown here.
This diff is large: its 514 lines aren’t shown here.
This diff is large: its 11 lines aren’t shown here.
This diff is large: its 17 lines aren’t shown here.
This diff is large: its 212 lines aren’t shown here.
This diff is large: its 93 lines aren’t shown here.
This diff is large: its 25 lines aren’t shown here.
This diff is large: its 25 lines aren’t shown here.
This diff is large: its 19 lines aren’t shown here.
This diff is large: its 34 lines aren’t shown here.
This diff is large: its 130 lines aren’t shown here.
This diff is large: its 200 lines aren’t shown here.
This diff is large: its 411 lines aren’t shown here.
This diff is large: its 32 lines aren’t shown here.
This diff is large: its 29 lines aren’t shown here.
This diff is large: its 18 lines aren’t shown here.
This diff is large: its 61 lines aren’t shown here.
This diff is large: its 307 lines aren’t shown here.
This diff is large: its 8 lines aren’t shown here.
This diff is large: its 117 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 27 lines aren’t shown here.
This diff is large: its 28 lines aren’t shown here.
This diff is large: its 533 lines aren’t shown here.
This diff is large: its 55 lines aren’t shown here.
This diff is large: its 57 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 20 lines aren’t shown here.
This diff is large: its 134 lines aren’t shown here.
This diff is large: its 24 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 653 lines aren’t shown here.
This diff is large: its 116 lines aren’t shown here.
This diff is large: its 153 lines aren’t shown here.
This diff is large: its 9 lines aren’t shown here.
This diff is large: its 127 lines aren’t shown here.
This diff is large: its 92 lines aren’t shown here.
This diff is larger than a page shows: the files after these aren’t listed. Clone the repository to see all of it.