← Documents Documentation/networking/device_drivers/ethernet/marvell/octeon_ep.rst GitHub 원문 ↗

Linux 6.18.37 · Networking

Linux kernel networking driver for Marvell's Octeon PCI Endpoint NIC

Marvell Octeon PCI Endpoint NIC driver의 지원 device와 BAR4 mailbox 기반 interface control 흐름을 설명합니다.

Source pathDocumentation/networking/device_drivers/ethernet/marvell/octeon_ep.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

octeon_ep.rst:1-41

Octeon PCI Endpoint NIC driver는 host의 interface 설정 요청을 BAR4 reserved region의 mailbox로 firmware에 전달합니다. 반대 방향에서는 firmware가 notification queue로 link event를 비동기 통지합니다.

Octeon EP 지원 device
계열Device ID
B1b100
B2b200
B4b400
B9b900
BAba00
BCbc00
BDbd00

현재 PF driver가 인식하는 Cavium network controller ID입니다.

BAR4 mailbox control
MTU·speed·link 요청driverBAR4 mailbox command queueOcteon firmware 처리
link change eventfirmwarenotification queuedriver 통지

command와 event가 mailbox의 서로 다른 queue를 통해 오갑니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0+
2
3 ====================================================================
4 Linux kernel networking driver for Marvell's Octeon PCI Endpoint NIC
5 ====================================================================
6
7 Network driver for Marvell's Octeon PCI EndPoint NIC.
8 Copyright (c) 2020 Marvell International Ltd.
9
10 Contents
11 ========
12
13 - `Overview`_
14 - `Supported Devices`_
15 - `Interface Control`_
16
17 Overview
18 ========
19 This driver implements networking functionality of Marvell's Octeon PCI
20 EndPoint NIC.
21
22 Supported Devices
23 =================
24 Currently, this driver support following devices:
25 * Network controller: Cavium, Inc. Device b100
26 * Network controller: Cavium, Inc. Device b200
27 * Network controller: Cavium, Inc. Device b400
28 * Network controller: Cavium, Inc. Device b900
29 * Network controller: Cavium, Inc. Device ba00
30 * Network controller: Cavium, Inc. Device bc00
31 * Network controller: Cavium, Inc. Device bd00
32
33 Interface Control
34 =================
35 Network Interface control like changing mtu, link speed, link down/up are
36 done by writing command to mailbox command queue, a mailbox interface
37 implemented through a reserved region in BAR4.
38 This driver writes the commands into the mailbox and the firmware on the
39 Octeon device processes them. The firmware also sends unsolicited notifications
40 to driver for events suchs as link change, through notification queue
41 implemented as part of mailbox interface.
42

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Octeon PCI Endpoint NIC 개요

1-21

이 문서는 `GPL-2.0+` 라이선스를 따릅니다.

Marvell Octeon PCI Endpoint NIC용 Linux kernel network driver

Marvell Octeon PCI EndPoint NIC용 network driver입니다.

Copyright (c) 2020 Marvell International Ltd.

목차

  • 개요
  • 지원 device
  • Interface control

개요

이 driver는 Marvell Octeon PCI EndPoint NIC의 networking 기능을 구현합니다.

.. SPDX-License-Identifier: GPL-2.0+

====================================================================
Linux kernel networking driver for Marvell's Octeon PCI Endpoint NIC
====================================================================

Network driver for Marvell's Octeon PCI EndPoint NIC.
Copyright (c) 2020 Marvell International Ltd.

Contents
========

- `Overview`_
- `Supported Devices`_
- `Interface Control`_

Overview
========
This driver implements networking functionality of Marvell's Octeon PCI
EndPoint NIC.

지원 device

22-32

지원 device

현재 이 driver는 다음 network controller를 지원합니다.

  • Cavium, Inc. Device b100
  • Cavium, Inc. Device b200
  • Cavium, Inc. Device b400
  • Cavium, Inc. Device b900
  • Cavium, Inc. Device ba00
  • Cavium, Inc. Device bc00
  • Cavium, Inc. Device bd00
Supported Devices
=================
Currently, this driver support following devices:
 * Network controller: Cavium, Inc. Device b100
 * Network controller: Cavium, Inc. Device b200
 * Network controller: Cavium, Inc. Device b400
 * Network controller: Cavium, Inc. Device b900
 * Network controller: Cavium, Inc. Device ba00
 * Network controller: Cavium, Inc. Device bc00
 * Network controller: Cavium, Inc. Device bd00

Mailbox 기반 interface control

33-41

Interface control

MTU 변경, link speed 변경, link down/up 같은 network interface control은 mailbox command queue에 command를 써서 수행합니다. mailbox interface는 BAR4의 reserved region을 통해 구현됩니다.

driver가 command를 mailbox에 쓰면 Octeon device의 firmware가 이를 처리합니다.

firmware는 link change 같은 event가 발생하면 mailbox interface의 일부로 구현된 notification queue를 통해 driver에 요청하지 않은 notification도 보냅니다.

Interface Control
=================
Network Interface control like changing mtu, link speed, link down/up are
done by writing command to mailbox command queue, a mailbox interface
implemented through a reserved region in BAR4.
This driver writes the commands into the mailbox and the firmware on the
Octeon device processes them. The firmware also sends unsolicited notifications
to driver for events suchs as link change, through notification queue
implemented as part of mailbox interface.