| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123 |
- #ifndef ETHERNET_SERVICE_H
- #define ETHERNET_SERVICE_H
- #include <QObject>
- #include <QString>
- #include <QStringList>
- #include <QJsonObject>
- #include <QJsonValue>
- #include <QVariantMap>
- /**
- * 有线网卡配置 (基于 EnjoySDK, 走系统 EthernetService, 无需 root).
- *
- * 【为什么不用 ifconfig】
- * shell 的 ifconfig 改网卡需要 CAP_NET_ADMIN, 普通 app uid 必然 EPERM;
- * 设备未 root 时 su 也拿不到权限。EnjoySDK 通过系统 EthernetService(system uid)
- * 下发配置, 普通应用即可生效, 这也是本项目配置 eth0/eth1 的正确路径。
- *
- * 【关键约束:mode=STATIC 必须与 IP 一次性下发】
- * setEthernetConfig 会校验**整个配置对象**:静态模式下 IP/子网掩码必须合法,
- * 否则返回 ERR_CONFIG_INVALID = -101。
- * 所以不能"先只改 mode 提交一次、再填 IP 提交第二次"——第一次提交时 IP 还是
- * DHCP 遗留的 0.0.0.0,校验必然失败。
- * 正确做法(已封装在 {@link setStaticIp}):mode=STATIC 与 IP/掩码/网关/DNS
- * 在同一次调用里一起给。
- *
- * 【模式与状态常量】(与 Java 侧 EthernetBridge 一致)
- * mode: DHCP=1 / STATIC=2 / PPPOE=3 / UNKNOWN=4
- * linkState: DISCONNECTED=0 / CONNECTING=1 / CONNECTED=2
- * DISCONNECTING=3 / UNKNOWN=4
- *
- * 非 Android 平台所有接口返回失败码, 可安全调用不会崩溃。
- */
- class EthernetService : public QObject
- {
- Q_OBJECT
- public:
- explicit EthernetService(QObject *parent = nullptr);
- ~EthernetService() override;
- /** 本平台是否支持 EnjoySDK 网卡配置。 */
- Q_INVOKABLE bool isSupported() const;
- /**
- * 列出系统所有有线网卡名。
- * @return 网卡名列表, 如 ["eth0","eth1"]; 失败时为空。
- */
- Q_INVOKABLE QStringList devices() const;
- /**
- * 查询网卡状态。
- * @param iface 网卡名, 如 "eth1"
- * @return 形如:
- * { linkState:2, enabled:true, mac:"...", mode:2,
- * ip:"192.168.100.101", subnetMask:"255.255.255.0",
- * gateway:"", dns:"", backupDns:"", ok:true }
- * 失败时 ok=false, 并带 error 字段。
- */
- Q_INVOKABLE QVariantMap status(const QString &iface) const;
- /**
- * 切换 DHCP / 静态模式(只改模式, 不动 IP 参数)。
- * @param iface 网卡名
- * @param useDhcp true=DHCP, false=静态
- */
- Q_INVOKABLE QVariantMap setDhcp(const QString &iface, bool useDhcp) const;
- /**
- * 设置静态 IP。
- * 内部把 mode=STATIC 与 IP/掩码/网关/DNS **一次性**下发
- * (分两步提交必被系统拒 -101,见类注释)。
- * @param iface 网卡名
- * @param ip 静态 IP, 必填
- * @param subnetMask 子网掩码, 留空则默认 255.255.255.0
- * @param gateway 网关, 可留空(相机专用网卡建议留空,避免抢默认路由)
- * @param dns DNS, 可留空
- */
- Q_INVOKABLE QVariantMap setStaticIp(const QString &iface,
- const QString &ip,
- const QString &subnetMask = QString(),
- const QString &gateway = QString(),
- const QString &dns = QString()) const;
- /** 开关网卡。 */
- Q_INVOKABLE QVariantMap setEnabled(const QString &iface, bool enabled) const;
- /**
- * 设置网卡 MTU(Jumbo 帧, 如 9000)。
- *
- * 【注意】EnjoySDK 未提供 MTU 接口, 只能走 shell 的 ifconfig,
- * 而修改 MTU 需要 CAP_NET_ADMIN —— 普通 app uid 一定被拒(EPERM),
- * 只有设备已 root 且 su 可用才能成功。失败不影响已下发的 IP 配置。
- * MTU 必须在该网卡 down 状态下修改, 内部会自动 down -> mtu -> up。
- *
- * @param iface 网卡名
- * @param mtu 目标 MTU, 如 9000
- * @return { ok:bool, applied:int, msg:QString }
- * ok=false 且 msg 含 EPERM/Operation not permitted 表示缺 root;
- * ok=false 且 msg 含 Invalid argument 表示驱动不支持该 MTU 值。
- */
- Q_INVOKABLE QVariantMap setMtu(const QString &iface, int mtu) const;
- /** 错误信息(最近一次失败的原因), 便于 QML 侧展示。 */
- Q_INVOKABLE QString lastError() const;
- // ---- 常量, 供 QML 侧直接引用, 避免在 QML 里写魔法数字 ----
- static constexpr int MODE_DHCP = 1;
- static constexpr int MODE_STATIC = 2;
- static constexpr int MODE_PPPOE = 3;
- static constexpr int MODE_UNKNOWN = 4;
- static constexpr int STATE_DISCONNECTED = 0;
- static constexpr int STATE_CONNECTING = 1;
- static constexpr int STATE_CONNECTED = 2;
- static constexpr int STATE_DISCONNECTING = 3;
- static constexpr int STATE_UNKNOWN = 4;
- private:
- mutable QString m_lastError;
- };
- #endif // ETHERNET_SERVICE_H
|