ethernet_service.h 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123
  1. #ifndef ETHERNET_SERVICE_H
  2. #define ETHERNET_SERVICE_H
  3. #include <QObject>
  4. #include <QString>
  5. #include <QStringList>
  6. #include <QJsonObject>
  7. #include <QJsonValue>
  8. #include <QVariantMap>
  9. /**
  10. * 有线网卡配置 (基于 EnjoySDK, 走系统 EthernetService, 无需 root).
  11. *
  12. * 【为什么不用 ifconfig】
  13. * shell 的 ifconfig 改网卡需要 CAP_NET_ADMIN, 普通 app uid 必然 EPERM;
  14. * 设备未 root 时 su 也拿不到权限。EnjoySDK 通过系统 EthernetService(system uid)
  15. * 下发配置, 普通应用即可生效, 这也是本项目配置 eth0/eth1 的正确路径。
  16. *
  17. * 【关键约束:mode=STATIC 必须与 IP 一次性下发】
  18. * setEthernetConfig 会校验**整个配置对象**:静态模式下 IP/子网掩码必须合法,
  19. * 否则返回 ERR_CONFIG_INVALID = -101。
  20. * 所以不能"先只改 mode 提交一次、再填 IP 提交第二次"——第一次提交时 IP 还是
  21. * DHCP 遗留的 0.0.0.0,校验必然失败。
  22. * 正确做法(已封装在 {@link setStaticIp}):mode=STATIC 与 IP/掩码/网关/DNS
  23. * 在同一次调用里一起给。
  24. *
  25. * 【模式与状态常量】(与 Java 侧 EthernetBridge 一致)
  26. * mode: DHCP=1 / STATIC=2 / PPPOE=3 / UNKNOWN=4
  27. * linkState: DISCONNECTED=0 / CONNECTING=1 / CONNECTED=2
  28. * DISCONNECTING=3 / UNKNOWN=4
  29. *
  30. * 非 Android 平台所有接口返回失败码, 可安全调用不会崩溃。
  31. */
  32. class EthernetService : public QObject
  33. {
  34. Q_OBJECT
  35. public:
  36. explicit EthernetService(QObject *parent = nullptr);
  37. ~EthernetService() override;
  38. /** 本平台是否支持 EnjoySDK 网卡配置。 */
  39. Q_INVOKABLE bool isSupported() const;
  40. /**
  41. * 列出系统所有有线网卡名。
  42. * @return 网卡名列表, 如 ["eth0","eth1"]; 失败时为空。
  43. */
  44. Q_INVOKABLE QStringList devices() const;
  45. /**
  46. * 查询网卡状态。
  47. * @param iface 网卡名, 如 "eth1"
  48. * @return 形如:
  49. * { linkState:2, enabled:true, mac:"...", mode:2,
  50. * ip:"192.168.100.101", subnetMask:"255.255.255.0",
  51. * gateway:"", dns:"", backupDns:"", ok:true }
  52. * 失败时 ok=false, 并带 error 字段。
  53. */
  54. Q_INVOKABLE QVariantMap status(const QString &iface) const;
  55. /**
  56. * 切换 DHCP / 静态模式(只改模式, 不动 IP 参数)。
  57. * @param iface 网卡名
  58. * @param useDhcp true=DHCP, false=静态
  59. */
  60. Q_INVOKABLE QVariantMap setDhcp(const QString &iface, bool useDhcp) const;
  61. /**
  62. * 设置静态 IP。
  63. * 内部把 mode=STATIC 与 IP/掩码/网关/DNS **一次性**下发
  64. * (分两步提交必被系统拒 -101,见类注释)。
  65. * @param iface 网卡名
  66. * @param ip 静态 IP, 必填
  67. * @param subnetMask 子网掩码, 留空则默认 255.255.255.0
  68. * @param gateway 网关, 可留空(相机专用网卡建议留空,避免抢默认路由)
  69. * @param dns DNS, 可留空
  70. */
  71. Q_INVOKABLE QVariantMap setStaticIp(const QString &iface,
  72. const QString &ip,
  73. const QString &subnetMask = QString(),
  74. const QString &gateway = QString(),
  75. const QString &dns = QString()) const;
  76. /** 开关网卡。 */
  77. Q_INVOKABLE QVariantMap setEnabled(const QString &iface, bool enabled) const;
  78. /**
  79. * 设置网卡 MTU(Jumbo 帧, 如 9000)。
  80. *
  81. * 【注意】EnjoySDK 未提供 MTU 接口, 只能走 shell 的 ifconfig,
  82. * 而修改 MTU 需要 CAP_NET_ADMIN —— 普通 app uid 一定被拒(EPERM),
  83. * 只有设备已 root 且 su 可用才能成功。失败不影响已下发的 IP 配置。
  84. * MTU 必须在该网卡 down 状态下修改, 内部会自动 down -> mtu -> up。
  85. *
  86. * @param iface 网卡名
  87. * @param mtu 目标 MTU, 如 9000
  88. * @return { ok:bool, applied:int, msg:QString }
  89. * ok=false 且 msg 含 EPERM/Operation not permitted 表示缺 root;
  90. * ok=false 且 msg 含 Invalid argument 表示驱动不支持该 MTU 值。
  91. */
  92. Q_INVOKABLE QVariantMap setMtu(const QString &iface, int mtu) const;
  93. /** 错误信息(最近一次失败的原因), 便于 QML 侧展示。 */
  94. Q_INVOKABLE QString lastError() const;
  95. // ---- 常量, 供 QML 侧直接引用, 避免在 QML 里写魔法数字 ----
  96. static constexpr int MODE_DHCP = 1;
  97. static constexpr int MODE_STATIC = 2;
  98. static constexpr int MODE_PPPOE = 3;
  99. static constexpr int MODE_UNKNOWN = 4;
  100. static constexpr int STATE_DISCONNECTED = 0;
  101. static constexpr int STATE_CONNECTING = 1;
  102. static constexpr int STATE_CONNECTED = 2;
  103. static constexpr int STATE_DISCONNECTING = 3;
  104. static constexpr int STATE_UNKNOWN = 4;
  105. private:
  106. mutable QString m_lastError;
  107. };
  108. #endif // ETHERNET_SERVICE_H