xs2184-tsw202: add package to control PoE for TSW202 device

this package is used to configure the Power-over-Ethernet

controller xs2184 found on TSW202 switches.

The PoE doesn't work without this package.

Investigation and Dokuments

'https://git.f2a.space/patrick/openwrt-24.10-tsw202/
-/wikis/POE-XS2184'

Signed-off-by: Patrick Grimm <[email protected]>

Author: stargieg

utils/xs2184-tsw202/Makefile

@@ -0,0 +1,53 @@
+include $(TOPDIR)/rules.mk
+
+
+PKG_NAME:=xs2184-tsw202
+PKG_VERSION:=1.0.2
+PKG_RELEASE:=1
+
+PKG_BUILD_DIR:=$(BUILD_DIR)/$(PKG_NAME)
+PKG_MAINTAINER:=patrick <[email protected]>
+
+include $(INCLUDE_DIR)/package.mk
+
+ifeq ($(CONFIG_BIG_ENDIAN),y)
+TARGET_CFLAGS+= -DHAVE_BIG_ENDIAN=1
+endif
+TARGET_CFLAGS+= -D_GNU_SOURCE
+
+define Package/xs2184-tsw202
+  SECTION:=Applications
+  CATEGORY:=Network
+  SECTION:=utils
+  CATEGORY:=Utilities
+  TITLE:=XinSheng PoE/PSE i2c driver for Teltonika TSW202 Switch
+  DEPENDS:=+i2c-tools +libuci
+endef
+
+define Package/xs2184-tsw202/description
+  ZheJiang XinSheng PoE/PSE SoC devices drivers;
+endef
+
+define Build/Prepare
+	mkdir -p $(PKG_BUILD_DIR)
+	$(CP) ./files $(PKG_BUILD_DIR)/
+endef
+
+define Build/Compile
+	$(MAKE) -C $(PKG_BUILD_DIR)/files \
+		$(TARGET_CONFIGURE_OPTS) \
+		TARGET=Linux \
+		CFLAGS="$(TARGET_CFLAGS)" \
+		LDFLAGS="$(TARGET_LDFLAGS)"
+endef
+
+define Package/xs2184-tsw202/install
+	$(INSTALL_DIR) $(1)/usr/sbin
+	$(INSTALL_BIN) $(PKG_BUILD_DIR)/files/xs2184 $(1)/usr/sbin/
+	$(INSTALL_DIR) $(1)/etc/init.d
+	$(INSTALL_BIN) ./files/xs2184.init $(1)/etc/init.d/xs2184
+	$(INSTALL_DIR) $(1)/etc/config
+	$(INSTALL_DATA) ./files/xs2184.config $(1)/etc/config/xs2184
+endef
+
+$(eval $(call BuildPackage,xs2184-tsw202))

utils/xs2184-tsw202/README.md

@@ -0,0 +1,47 @@
+# XS2184 PSE driver and monitor app
+
+## 检测原理
+- 正常工作时, PSE 协商使能, 供电给 PD, 并统计15轮 实时功耗;
+- 当平均功耗 为0, 判定 PD 出现异常, 关闭 PSE 对应 Port的供电;
+- 被关闭的 Port, 在下一轮统计时, 重新开启协商供电使能;
+- 实测, MS1800K 在 上电复位异常情况下, 实时功耗 为0 mW, 能被识别出异常, 并断电重启;
+
+## 测试方法
+1. 正常 PoE - PD 组网;
+2. 后台执行:  xs2184 -m 1000;
+3. xs2184 监听模式, 参数 -m: monitor 模式, 检测间隔 1000ms, 平均功耗计算周期: 默认 15 轮, -s <ms> 可修改;
+4. 观察 xs2184 日志, 会实时打印功耗和检测状态;
+5. 用镊子短路 MS1800K 的 C133 复位电容, 模拟上电无法启动的情况;
+6. 重复4), 对比关电和重新上电的行为, 以及MS1800K重新开机和功耗变化;
+
+## Funktionsprinzip
+- Im Normalbetrieb verhandelt die PSE die Freigabe, versorgt das PD mit Strom und zeichnet den Stromverbrauch in Echtzeit über 15 Zyklen auf.
+- Wenn der durchschnittliche Stromverbrauch Null erreicht, wird das PD als fehlerhaft eingestuft und die PSE unterbricht die Stromversorgung des entsprechenden Ports.
+- Der deaktivierte Port verhandelt während des nächsten Verbrauchszyklus erneut die Freigabe der Stromversorgung.
+- Feldtests bestätigen, dass der MS1800K unter abnormalen Power-On-Reset-Bedingungen einen Echtzeit-Stromverbrauch von null mW aufweist, was die Erkennung von Anomalien und den anschließenden Neustart nach dem Ausschalten ermöglicht.
+
+## Testmethodik
+1. Standard-PoE-PD-Netzwerkkonfiguration.
+2. Hintergrundausführung: xs2184 -m 1000.
+3. xs2184-Überwachungsmodus, Parameter -m: Überwachungsmodus, Erkennungsintervall 1000 ms, durchschnittlicher Stromverbrauchsberechnungszyklus: standardmäßig 15 Runden, änderbar mit -s in ms;
+4. Beobachten Sie die xs2184-Protokolle, die den Stromverbrauch und den Erkennungsstatus in Echtzeit anzeigen.
+5. Verwenden Sie eine Pinzette, um den C133-Reset-Kondensator des MS1800K kurzzuschließen und so einen Fehler beim Hochfahren nach dem Einschalten zu simulieren.
+6. Wiederholen Sie Schritt 4 und vergleichen Sie das Verhalten nach dem Ausschalten und erneuten Einschalten mit dem Neustart des MS1800K und den Änderungen des Stromverbrauchs.
+
+## UI einfach
+```
+uci add luci command
+uci set luci.@command[-1].name="poe-status"
+uci set luci.@command[-1].command="xs2184 -c"
+last=8
+for i in $(seq 1 $last);do
+uci add luci command
+uci set luci.@command[-1].name="poe-lan$i-on"
+uci set luci.@command[-1].command="xs2184 -u $last"
+uci add luci command
+uci set luci.@command[-1].name="poe-lan$i-off"
+uci set luci.@command[-1].command="xs2184 -d $last"
+last=$((last-1))
+done
+uci commit luci
+```

utils/xs2184-tsw202/files/Makefile

@@ -0,0 +1,13 @@
+SRCS= \
+      libxs2184/xs2184.c \
+      libxs2184/i2cbusses.c
+
+ifeq ($(CC),cc)
+CC=${CROSS_COMPILE}gcc
+endif
+
+all:
+	${CC} ${CFLAGS} -Wno-format-overflow -Wall -Werror -O1 -s ${SRCS} -o xs2184 ${LDFLAGS} -luci -lpthread -ldl
+
+clean:
+	-rm -f *.o xs2184