xref: /freebsd/share/man/man4/man4.aarch64/felix.4 (revision 4d846d260e2b9a3d4d0a701462568268cbfe7a5b)
1451bcf1bSMarcin Wojtas.\" -
2*4d846d26SWarner Losh.\" SPDX-License-Identifier: BSD-2-Clause
3451bcf1bSMarcin Wojtas.\"
4451bcf1bSMarcin Wojtas.\" Copyright (c) 2021 Alstom Group.
5451bcf1bSMarcin Wojtas.\" Copyright (c) 2021 Semihalf.
6451bcf1bSMarcin Wojtas.\"
7451bcf1bSMarcin Wojtas.\" Redistribution and use in source and binary forms, with or without
8451bcf1bSMarcin Wojtas.\" modification, are permitted provided that the following conditions
9451bcf1bSMarcin Wojtas.\" are met:
10451bcf1bSMarcin Wojtas.\" 1. Redistributions of source code must retain the above copyright
11451bcf1bSMarcin Wojtas.\"    notice, this list of conditions and the following disclaimer.
12451bcf1bSMarcin Wojtas.\" 2. Redistributions in binary form must reproduce the above copyright
13451bcf1bSMarcin Wojtas.\"    notice, this list of conditions and the following disclaimer in the
14451bcf1bSMarcin Wojtas.\"    documentation and/or other materials provided with the distribution.
15451bcf1bSMarcin Wojtas.\"
16451bcf1bSMarcin Wojtas.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17451bcf1bSMarcin Wojtas.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18451bcf1bSMarcin Wojtas.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19451bcf1bSMarcin Wojtas.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20451bcf1bSMarcin Wojtas.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21451bcf1bSMarcin Wojtas.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22451bcf1bSMarcin Wojtas.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23451bcf1bSMarcin Wojtas.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24451bcf1bSMarcin Wojtas.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25451bcf1bSMarcin Wojtas.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26451bcf1bSMarcin Wojtas.\" SUCH DAMAGE.
27451bcf1bSMarcin Wojtas.\"
28451bcf1bSMarcin Wojtas.Dd June 21, 2021
29451bcf1bSMarcin Wojtas.Dt FELIX 4
30451bcf1bSMarcin Wojtas.Os
31451bcf1bSMarcin Wojtas.Sh NAME
32451bcf1bSMarcin Wojtas.Nm felix
33451bcf1bSMarcin Wojtas.Nd "driver for Microchip Ocelot Felix switch"
34451bcf1bSMarcin Wojtas.Sh SYNOPSIS
35451bcf1bSMarcin WojtasTo compile this driver into the kernel the following lines must be present
36451bcf1bSMarcin Wojtasin the kernel configuration file:
37451bcf1bSMarcin Wojtas.sp
38451bcf1bSMarcin Wojtas.Cd "options SOC_NXP_LS"
39451bcf1bSMarcin Wojtas.Cd "device pci"
40451bcf1bSMarcin Wojtas.Cd "device fdt"
41451bcf1bSMarcin Wojtas.Cd "device mdio"
42451bcf1bSMarcin Wojtas.Cd "device enetc"
43451bcf1bSMarcin Wojtas.Cd "device etherswitch"
44451bcf1bSMarcin Wojtas.Cd "device felix"
45451bcf1bSMarcin Wojtas.Sh DESCRIPTION
46451bcf1bSMarcin WojtasThe
47451bcf1bSMarcin Wojtas.Nm
48451bcf1bSMarcin Wojtasdriver provides a management interface to Microchip Ocelot Felix switch (VSC9959)
49451bcf1bSMarcin Wojtasfound in NXP LS1028A SoC. It is a PCI device, part of the larger ENETC
50451bcf1bSMarcin Wojtasroot complex. The driver is using
51451bcf1bSMarcin Wojtas.Xr etherswitch 4
52451bcf1bSMarcin Wojtasframework.
53451bcf1bSMarcin Wojtas.Pp
54451bcf1bSMarcin WojtasThis driver supports only dot1q vlan. dot1q support port base addtag, striptag,
55451bcf1bSMarcin Wojtasdropuntagged, dropuntagged.
56451bcf1bSMarcin Wojtas.Sh EXAMPLES
57451bcf1bSMarcin WojtasConfigure dot1q vlan by etherswitchcfg command.
58451bcf1bSMarcin Wojtas.Pp
59451bcf1bSMarcin Wojtas.Dl # etherswitchcfg config vlan_mode dot1q
60451bcf1bSMarcin Wojtas.Pp
61451bcf1bSMarcin WojtasConfigure port 5 is tagging port.
62451bcf1bSMarcin Wojtas.Pp
63451bcf1bSMarcin Wojtas.Dl # etherswitchcfg port5 addtag
64451bcf1bSMarcin Wojtas.Pp
65451bcf1bSMarcin WojtasDisable port 5 is tagging port.
66451bcf1bSMarcin Wojtas.Pp
67451bcf1bSMarcin Wojtas.Dl # etherswitchcfg port5 -addtag
68451bcf1bSMarcin Wojtas.Sh SEE ALSO
69451bcf1bSMarcin Wojtas.Xr etherswitch 4 ,
70451bcf1bSMarcin Wojtas.Xr etherswitchcfg 8
71451bcf1bSMarcin Wojtas.Sh HISTORY
72451bcf1bSMarcin WojtasThe
73451bcf1bSMarcin Wojtas.Nm
74451bcf1bSMarcin Wojtasdevice driver first appeared in
75451bcf1bSMarcin Wojtas.Fx 14.0 .
76451bcf1bSMarcin Wojtas.Sh AUTHORS
77451bcf1bSMarcin WojtasThe
78451bcf1bSMarcin Wojtas.Nm
79451bcf1bSMarcin Wojtasdriver was written by
80451bcf1bSMarcin Wojtas.An Kornel Duleba (mindal@semihalf.com)
81451bcf1bSMarcin Wojtasand
82451bcf1bSMarcin Wojtas.An Lukasz Hajec (lha@semihalf.com)
83451bcf1bSMarcin Wojtas
84