Skip to content

Commit

Permalink
ffac-mt7915-hotfix: initial package version
Browse files Browse the repository at this point in the history
This package reboots the device if the mt7915-firmware hangs on ramips-mt7621
and mediatek-filogic. It's meant as a hotfix for the mcu timeout issue:
freifunk-gluon/gluon#3154
  • Loading branch information
maurerle committed Aug 12, 2024
1 parent db0a519 commit 22f80e8
Show file tree
Hide file tree
Showing 5 changed files with 92 additions and 0 deletions.
21 changes: 21 additions & 0 deletions ffac-mt7915-hotfix/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2024 Felix Baumann

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
23 changes: 23 additions & 0 deletions ffac-mt7915-hotfix/Makefile
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# SPDX-FileCopyrightText: 2024 Felix Baumann (FFAC)
# SPDX-License-Identifier: MIT
include $(TOPDIR)/rules.mk

PKG_NAME:=ffac-mt7915-hotfix
PKG_VERSION:=1
PKG_RELEASE:=1

PKG_LICENSE:=MIT

PKG_BUILD_DIR := $(BUILD_DIR)/$(PKG_NAME)

include $(TOPDIR)/../package/gluon.mk

define Package/$(PKG_NAME)
SECTION:=gluon
CATEGORY:=Gluon
TITLE:=reboot device if mt7915e driver shows known failure symptom
DEPENDS:=@(TARGET_mediatek_filogic||TARGET_ramips_mt7621||TARGET_ramips_mt7622) kmod-mt7915e +gluon-core +micrond
MAINTAINER:=Freifunk Aachen <[email protected]>
endef

$(eval $(call BuildPackageGluon,$(PKG_NAME)))
34 changes: 34 additions & 0 deletions ffac-mt7915-hotfix/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
ffac-mt7915-hotfix
=============

This script reboots the device if the mt7915-firmware hangs on ramips-mt7621
and mediatek-filogic. It's meant as a hotfix for the mcu timeout issue:
https://github.com/freifunk-gluon/gluon/issues/3154
The issue popped up with Gluon v2023.2, earlier releases are not affected.

Create a file `modules` with the following content in your `./gluon/site/`
directory and add these lines:

```
GLUON_SITE_FEEDS="community"
PACKAGES_COMMUNITY_REPO=https://github.com/freifunk-gluon/community-packages.git
PACKAGES_COMMUNITY_COMMIT=*/missing/*
PACKAGES_COMMUNITY_BRANCH=master
```

Now you can add the package `ffac-mt7915-hotfix` to your site.mk
(`*/missing/*` has to be replaced by the github-commit-ID of the version you
want to use, you have to pick it manually.)

Further info on the issue this tries to prevent from happening:
I've seen the MCU timeout issue happening as early as 16 hours of uptime.
MCU timeouts result in WiFi not working. WiFi mesh nodes running into the
issue go offline until they are rebooted manually while any wired node is
still accessible via ssh.

On most devices it will take days or weeks for this issue to manifest,
while others are affected daily. This is due to the difference in clients
that are connecting to it on a frequent base. The more people frequent
the device the more probable it is to go offline.

Also see https://github.com/freifunk-gluon/gluon/issues/3154
12 changes: 12 additions & 0 deletions ffac-mt7915-hotfix/files/lib/gluon/mt7915/reboot-on-error.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
#!/bin/sh
if ls /sys/kernel/debug/ieee80211/phy*/mt76/rf_regval > /dev/null && ! cat /sys/kernel/debug/ieee80211/phy*/mt76/rf_regval > /dev/null; then
logger -s -t "ffac-mt7915-hotfix" -p err "wifi firmware crashed, scheduled reboot in 5 seconds"
sleep 5
# Autoupdate?
upgrade_started='/tmp/autoupdate.lock'
if [ -f $upgrade_started ] ; then
logger -s -t "ffac-mt7915-hotfix" -p 5 "Autoupdate running! Aborting"
exit 2
fi
reboot
fi
2 changes: 2 additions & 0 deletions ffac-mt7915-hotfix/files/usr/lib/micron.d/mt7915-hotfix
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
# run every second minute
*/2 * * * * /lib/gluon/mt7915/reboot-on-error.sh

0 comments on commit 22f80e8

Please sign in to comment.