1.\" 2.\" Copyright (c) 2016 Justin Hibbits 3.\" 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 15.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR 16.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 17.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 18.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, 19.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 20.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 21.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 22.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 23.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 24.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 25.\" 26.\" $FreeBSD$ 27.\" 28.Dd March 16, 2017 29.Dt DTSEC 4 30.Os 31.Sh NAME 32.Nm dtsec 33.Nd "Freescale Datapath Acceleration Architecture-based Three-Speed Ethernet Controller device driver" 34.Sh SYNOPSIS 35To compile this driver into the kernel, place the following lines in your 36kernel configuration file: 37.Bd -ragged -offset indent 38.Cd "include ""dpaa/config.dpaa"" 39.Cd "device dpaa" 40.Cd "device miibus" 41.Ed 42.Sh DESCRIPTION 43The 44.Nm 45driver provides support for the DPAA-based gigabit Ethernet controller 46integrated in some of the Freescale system-on-chip devices. 47.Pp 48The 49.Nm 50driver supports the following media types: 51.Bl -tag -width xxxxxxxxxxxxxxxxxxxx 52.It autoselect 53Enable autoselection of the media type and options 54.It 10baseT/UTP 55Set 10Mbps operation 56.It 100baseTX 57Set 100Mbps operation 58.It 1000baseT 59Set 1000baseT operation 60.El 61.Pp 62The 63.Nm 64driver supports the following media options: 65.Bl -tag -width xxxxxxxxxxxxxxxxxxxx 66.It full-duplex 67Set full duplex operation 68.El 69.Pp 70The 71.Nm 72driver supports two operating modes: 73.Bl -tag -width xxxxxxxxxxxxxxxxxxxx 74.It Regular 75Normal mode, utilizing the full datapath acceleration, Buffer Manager, and Queue 76Manager. 77.It Independent 78Runs disconnected from the Buffer Manager and Queue Manager. 79.El 80.Sh HARDWARE 81Gigabit Ethernet controllers built into the following Freescale 82system-on-chip devices are known to work with the 83.Nm 84driver: 85.Pp 86.Bl -bullet -compact 87.It 88P2041, P3041 89.It 90P5010, P5020 91.El 92.Sh SEE ALSO 93.Xr altq 4 , 94.Xr arp 4 , 95.Xr miibus 4 , 96.Xr netintro 4 , 97.Xr ng_ether 4 , 98.Xr ifconfig 8 99.Sh BUGS 100The 101.Nm 102driver assumes that there is only one Frame Manager, and that dtsec0 controls 103the MDIO interface. Though this is the case for the supported devices, other 104SoCs with the DPAA controller may not work correctly. Particularly, the P5040 105and P4080 SoCs have two frame managers, which breaks this assumption. 106.Sh HISTORY 107The 108.Nm 109device driver first appeared in 110.Fx 11.0 . 111.Sh AUTHORS 112.An -nosplit 113The base version of 114.Nm 115device driver was written by 116.An Semihalf . 117This manual page was written by 118.An Justin Hibbits . 119