【Linux】一步一步学Linux——mii-tool命令(154)

00. 目录

文章目录

01. 命令概述

mii-tool命令是用于查看、管理介质的网络接口的状态，有时网卡需要配置协商方式，比如10/100/1000M的网卡半双工、全双工、自动协商的配置。但大多数的网络设备是不用我们来修改协商，因为大多数网络设置接入的时候，都采用自动协商来解决相互通信的问题。不过自动协商也不是万能的，有时也会出现错误，比如丢包率比较高，这时就要我们来指定网卡的协商方式。mii-tool就是能指定网卡的协商方式。

02. 命令格式

格式：mii-tool [参数] [设备接口]

  • 1

03. 常用选项

-V 显示版本信息
-v 显示网络接口的信息
-R 重设MII到开启状态
-r 重启自动协商模式
-w 查看网络接口连接的状态变化
-l 写入事件到系统日志
-A 指令特定的网络接口
-F 更改网络接口协商方式

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8

04. 参考示例

4.1 查看指定网卡状态

[root@localhost ~]# mii-tool ens33
ens33: negotiated 1000baseT-FD flow-control, link ok
[root@localhost ~]# 

  • 1
  • 2
  • 3

4.2 查看网络接口的协商状态

[root@localhost ~]# mii-tool -v ens33
ens33: negotiated 1000baseT-FD flow-control, link ok
  product info: Yukon 88E1011 rev 3
  basic mode:   autonegotiation enabled
  basic status: autonegotiation complete, link ok
  capabilities: 1000baseT-FD 100baseTx-FD 100baseTx-HD 10baseT-FD 10baseT-HD
  advertising:  1000baseT-FD 100baseTx-FD 100baseTx-HD 10baseT-FD 10baseT-HD
  link partner: 1000baseT-HD 1000baseT-FD 100baseTx-FD 100baseTx-HD 10baseT-FD 10baseT-HD
[root@localhost ~]# 

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9

4.3 网络接口eth0改为1000Mb/s全双工的模式

[root@localhost ~]# mii-tool ens33 -F 100baseTx-FD


  • 1
  • 2

全双工：允许同时收包、发包，该模式在网卡链接交换机时启用
半双工：在同一时刻，只能收包或发包，该模式在网卡连接集线器时启用
自协商：启用时根据所连接设备，由网卡自行设定传输模式为全双工或半双工

4.4 重启自动协商模式

[root@localhost ~]# mii-tool -r ens33
restarting autonegotiation...
[root@localhost ~]# 

  • 1
  • 2
  • 3

4.5 显示版本信息

[root@localhost ~]# mii-tool -V 
net-tools 2.10-alpha
David Hinds based on Donald Becker's mii-diag
[root@localhost ~]# 

  • 1
  • 2
  • 3
  • 4

05. 附录

参考：【Linux】一步一步学Linux系列教程汇总

id="article_content" class="article_content clearfix"> id="content_views" class="markdown_views prism-atom-one-light">

概述

功能简介

PIN即管脚控制器，用于统一管理各SoC的管脚资源，对外提供管脚复用功能：包括管脚推拉方式、管脚推拉强度以及管脚功能。

PIN接口定义了操作PIN管脚的通用方法集合，包括：

  • 获取/释放管脚描述句柄：传入管脚名与链表中每个控制器下管脚名进行匹配，匹配则会获取一个管脚描述句柄，操作完PIN管脚后释放该管脚描述句柄。

  • 设置/获取管脚推拉方式：推拉方式可以是上拉、下拉以及悬空。

  • 设置/获取管脚推拉强度：用户可根据实际设置管脚推拉强度大小。

  • 设置/获取管脚功能：通过管脚功能名设置/获取管脚功能，实现管脚复用。

基本概念

PIN是一个软件层面的概念，目的是为了统一各SoC的PIN管脚管理，对外提供管脚复用功能，配置PIN管脚的电气特性。

  • SoC（System on Chip）

系统级芯片，也有称作片上系统，通常是面向特定用途将微处理器、模拟IP核、数字IP核和存储器集成在单一芯片的标准产品。

  • 管脚复用

由于芯片自身的引脚数量有限，无法满足日益增多的外接需求。此时可以通过软件层面的寄存器设置，让引脚工作在不同的状态，从而实现相同引脚完成不同功能的目的。

运作机制

在HDF框架中，同类型设备对象较多时（可能同时存在十几个同类型配置器），若采用独立服务模式，则需要配置更多的设备节点，且相关服务会占据更多的内存资源。相反，采用统一服务模式可以使用一个设备服务作为管理器，统一处理所有同类型对象的外部访问（这会在配置文件中有所体现），实现便捷管理和节约资源的目的。PIN模块接口适配模式采用统一服务模式。

在统一模式下，所有的控制器都被核心层统一管理，并由核心层统一发布一个服务供接口层，因此这种模式下驱动无需再为每个控制器发布服务。

PIN模块各分层作用：

  • 接口层提供获取PIN管脚、设置PIN管脚推拉方式、获取PIN管脚推拉方式、设置PIN管脚推拉强度、获取PIN管脚推拉强度、设置PIN管脚功能、获取PIN管脚功能、释放PIN管脚的接口。

  • 核心层主要提供PIN管脚资源匹配，PIN管脚控制器的添加、移除以及管理的能力，通过钩子函数与适配层交互。

  • 适配层主要是将钩子函数的功能实例化，实现具体的功能。

图 1 PIN统一服务模式

约束与限制

PIN模块目前只支持小型系统LiteOS-A内核。

使用指导

场景介绍

PIN模块仅是一个软件层面的概念，主要工作是管脚资源管理。使用复用管脚时，通过设置管脚功能、设置管脚推拉方式、设置管脚推拉强度来适配指定场景的需求。

接口说明

PIN模块提供的主要接口如表1所示，具体API详见//drivers/hdf_core/framework/include/platform/pin_if.h。

表 1 PIN驱动API接口功能介绍

class="table-box">
接口名描述
DevHandle PinGet(const char *pinName)获取管脚描述句柄
void PinPut(DevHandle handle)释放管脚描述句柄
int32_t PinSetPull(DevHandle handle, enum PinPullType pullType)设置管脚推拉方式
int32_t PinGetPull(DevHandle handle, enum PinPullType *pullType)获取管脚推拉方式
int32_t PinSetStrength(DevHandle handle, uint32_t strength)设置管脚推拉强度
int32_t PinGetStrength(DevHandle handle, uint32_t *strength)获取管脚推拉强度
int32_t PinSetFunc(DevHandle handle, const char *funcName)设置管脚功能
int32_t PinGetFunc(DevHandle handle, const char **funcName)获取管脚功能

说明：
本文涉及PIN的所有接口，支持内核态及用户态使用。

开发步骤

使用PIN设备的一般流程如图2所示。

图 2 PIN使用流程图

获取PIN管脚描述句柄

在使用PIN进行管脚操作时，首先要调用PinGet获取管脚描述句柄，该函数会返回匹配传入管脚名的管脚描述句柄。

DevHandle PinGet(const char *pinName);
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
  • 1

表 2 PinGet参数和描述

class="table-box">
参数描述
pinName字符指针类型，管脚名
返回值描述
NULL获取PIN管脚描述句柄失败
handlePIN管脚描述句柄

假设PIN需要操作的管脚名为P18，获取其管脚描述句柄的示例如下：

DevHandle handle = NULL;    // PIN管脚描述句柄

char pinName = "P18";       // PIN管脚名
handle = PinGet(pinName);
if (handle == NULL) {
    HDF_LOGE("PinGet: get handle failed!\n");
    return HDF_FAILURE;
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
PIN设置管脚推拉方式

PIN设置管脚推拉方式的函数如下所示：

int32_t PinSetPull(DevHandle handle, enum PinPullType pullType);
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

表 3 参数和描述

class="table-box">
参数描述
handleDevHandle类型，PIN管脚描述句柄
pullType枚举类型，PIN管脚推拉方式
返回值描述
HDF_SUCCESSPIN设置管脚推拉方式成功
负数PIN设置管脚推拉方式失败

假设PIN要设置的管脚推拉方式为上拉，其实例如下：

int32_t ret;
enum PinPullType pullTypeNum;

// PIN设置管脚推拉方式
pullTypeNum = 1;
ret = PinSetPull(handle, pullTypeNum);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("PinSetPull: failed, ret %d\n", ret);
    return ret;
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
PIN获取管脚推拉方式

PIN获取管脚推拉方式的函数如下所示：

int32_t PinGetPull(DevHandle handle, enum PinPullType *pullType);
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

表 4 PinGetPull参数和描述

class="table-box">
参数描述
handleDevHandle类型，PIN管脚描述句柄
pullType枚举类型指针，接收PIN管脚推拉方式
返回值描述
HDF_SUCCESSPIN获取管脚推拉方式成功
负数PIN获取管脚推拉方式失败

PIN获取管脚推拉方式的实例如下：

int32_t ret;
enum PinPullType pullTypeNum;

// PIN获取管脚推拉方式
ret = PinGetPull(handle, &pullTypeNum);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("PinGetPull: failed, ret %d\n", ret);
    return ret;
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
PIN设置管脚推拉强度

PIN设置管脚推拉强度函数如下所示：

int32_t PinSetStrength(DevHandle handle, uint32_t strength);
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

表 5 PinSetStrength参数和描述

class="table-box">
参数描述
handleDevHandle类型，管脚描述句柄
strengthuint32_t类型，PIN管脚推拉强度
返回值描述
HDF_SUCCESSPIN设置管脚推拉强度成功
负数PIN设置管脚推拉强度失败

假设PIN要设置的管脚推拉强度为2，其实例如下：

int32_t ret;
uint32_t strengthNum;
// PIN设置管脚推拉强度
strengthNum = 2;
ret = PinSetStrength(handle, strengthNum);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("PinSetStrength: failed, ret %d\n", ret);
    return ret;
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
PIN获取管脚推拉强度

PIN设置管脚推拉强度后，可以通过PIN获取管脚推拉强度接口来查看PIN管脚推拉强度，PIN获取管脚推拉强度的函数如下所示：

int32_t PinGetStrength(DevHandle handle, uint32_t *strength);
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

表 6 PinGetStrength参数和描述

class="table-box">
参数描述
handleDevHandle类型，管脚描述句柄
strengthuint32_t类型指针，接收PIN管脚推拉强度
返回值描述
HDF_SUCCESSPIN获取管脚推拉强度成功
负数PIN获取管脚推拉强度失败

PIN获取管脚推拉强度的实例如下：

int32_t ret;
uint32_t strengthNum;

// PIN获取管脚推拉强度
ret = PinGetStrength(handle, &strengthNum);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("PinGetStrength: failed, ret %d\n", ret);
    return ret;
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
PIN设置管脚功能

管脚功能特指的是管脚复用的功能，每个管脚功能都不相同，管脚功能名详细可以参考//device/soc/hisilicon/hi3516dv300/sdk_liteos/hdf_config/pin/pin_config.hcs。

PIN设置管脚功能函数如下所示：

int32_t PinSetFunc(DevHandle handle, const char *funcName);
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

表 7 PinSetFunc参数和描述

class="table-box">
参数描述
handleDevHandle类型，管脚描述句柄
funcName字符指针类型，PIN管脚功能名
返回值描述
HDF_SUCCESSPIN设置管脚功能成功
负数PIN设置管脚功能失败

假设PIN需要设置的管脚功能为LSADC_CH1（ADC通道1），其实例如下：

int32_t ret;
char funcName = "LSADC_CH1";

// PIN设置管脚功能
ret = PinSetFunc(handle, funcName);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("PinSetFunc: failed, ret %d\n", ret);
    return ret;
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
PIN获取管脚功能

PIN设置管脚功能后，可以通过PIN获取管脚功能接口来查看PIN管脚功能，PIN获取管脚功能的函数如下所示：

int32_t PinGetFunc(DevHandle handle, const char **funcName);
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

表 8 PinGetFunc参数和描述

class="table-box">
参数描述
handleDevHandle类型，管脚描述句柄
funcName字符类型双指针，接收PIN管脚功能
返回值描述
HDF_SUCCESSPIN获取管脚功能成功
负数PIN获取管脚功能失败

PIN获取管脚功能的实例如下：

int32_t ret;
char *funcName = NULL;

// PIN获取管脚功能
ret = PinGetFunc(handle, &funcName);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("PinGetFunc: failed, ret %d\n", ret);
    return ret;
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
释放PIN管脚描述句柄

PIN不再进行任何操作后，需要释放PIN管脚描述管脚句柄，函数如下所示：

void PinPut(DevHandle handle);
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

表 9 PinPut参数和描述

class="table-box">
参数描述
handleDevHandle类型，管脚描述句柄
返回值描述
NA无返回值

PIN销毁管脚描述句柄实例如下：

PinPut(handle);
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

使用实例

下面将基于Hi3516DV300开发板展示使用PIN设置管脚相关属性完整操作，步骤主要如下：

  1. 传入要设置的管脚名，获取PIN管脚描述句柄。

  2. 通过PIN管脚描述句柄以及推拉方式pullTypeNum设置管脚推拉方式，如果操作失败则释放PIN管脚描述句柄。

  3. 通过PIN管脚描述句柄，并用pullTypeNum承接获取的管脚推拉方式，如果操作失败则释放PIN管脚描述句柄。

  4. 通过PIN管脚描述句柄以及推拉强度strengthNum设置管脚推拉强度，如果操作失败则释放PIN管脚描述句柄。

  5. 通过PIN管脚描述句柄，并用strengthNum承接获取的管脚推拉强度，如果操作失败则释放PIN管脚描述句柄。

  6. 通过PIN管脚描述句柄以及管脚功能名funName设置管脚功能，如果操作失败则释放PIN管脚描述句柄。

  7. 通过PIN管脚描述句柄，并用funName承接获取的管脚功能名，如果操作失败则释放PIN管脚描述句柄。

  8. 使用完PIN后，不再对管脚进行操作，释放PIN管脚描述句柄。

#include "hdf_log.h"                              // 标准日志打印头文件
#include "pin_if.h"                               // PIN标准接口头文件

int32_t PinTestSample(void)
{
    int32_t ret;
    uint32_t strengthNum;
    enum PinPullType pullTypeNum;
    char *pinName = NULL;
    const char *funcName = NULL;
    DevHandle handle = NULL;

    // PIN管脚名，要填写实际要设置的管脚名
    pinName = "P18"; 
    // PIN获取管脚描述句柄
    handle = PinGet(pinName);
    if (handle == NULL) {
        HDF_LOGE("PinTestSample: pin get fail!\n");
        return -1;
    }
    // PIN设置管脚推拉方式为上拉 
    pullTypeNum = 1;
    ret = PinSetPull(handle, pullTypeNum);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("PinTestSample: pin set pull fail, ret:%d\n", ret);
        goto ERR;
    }
    // PIN获取管脚推拉方式 
    ret = PinGetPull(handle, &pullTypeNum);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("PinTestSample: pin get pull fail, ret:%d\n", ret);
        goto ERR;
    }
    // PIN设置管脚推拉强度为2 
    strengthNum = 2;
    ret = PinSetStrength(handle, strengthNum);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("PinTestSample: pin set strength fail, ret:%d\n", ret);
        goto ERR;
    }
    // PIN获取管脚推拉强度 
    ret = PinGetStrength(handle, &strengthNum);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("PinTestSample: pin get strength fail, ret:%d\n", ret);
        goto ERR;
    }
    // PIN设置管脚功能为LSADC_CH1 
    funcName = "LSADC_CH1";
    ret = PinSetFunc(handle, funcName);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("PinTestSample: pin set func fail, ret:%d\n", ret);
        goto ERR;
    }
    // PIN获取管脚功能 
    ret = PinGetFunc(handle, &funcName);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("PinTestSample: pin get func fail, ret:%d\n", ret);
        goto ERR;
    }
    HDF_LOGD("PinTestSample: function tests end.", __func__);
ERR:
    // 释放PIN管脚描述句柄 
    PinPut(handle); 
    return ret;
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}"> class="hide-preCode-box">

如果大家想更加深入的学习 OpenHarmony（鸿蒙南向） 开发的全栈内容，不妨可以参考以下相关学习文档进行学习，助你快速提升自己：

OpenHarmony 开发环境搭建：https://qr18.cn/CgxrRy

《OpenHarmony源码解析》：https://qr18.cn/CgxrRy

系统架构分析：https://qr18.cn/CgxrRy

OpenHarmony 设备开发学习手册：https://qr18.cn/CgxrRy

在这里插入图片描述

OpenHarmony面试题（内含参考答案）：https://qr18.cn/CgxrRy

写在最后

data-report-view="{"mod":"1585297308_001","spm":"1001.2101.3001.6548","dest":"https://blog.csdn.net/maniuT/article/details/141112500","extend1":"pc","ab":"new"}">> id="blogExtensionBox" style="width:400px;margin:auto;margin-top:12px" class="blog-extension-box"> class="blog_extension blog_extension_type2" id="blog_extension"> class="extension_official" data-report-click="{"spm":"1001.2101.3001.6471"}" data-report-view="{"spm":"1001.2101.3001.6471"}"> class="blog_extension_card_left"> class="blog_extension_card_cont"> 鸿蒙开发学习资料领取！！！ class="blog_extension_card_cont_r"> 微信名片
注：本文转载自blog.csdn.net的沧海一笑-dj的文章"https://blog.csdn.net/dengjin20104042056/article/details/99710241"。版权归原作者所有，此博客不拥有其著作权，亦不承担相应法律责任。如有侵权，请联系我们删除。
复制链接
复制链接
相关推荐
发表评论

评论记录：

未查询到任何数据！