README.md

HELP NEEDED

Secureboot based module loading needs testing, as my test environment doesn't have secureboot. Please follow the Ubuntu SecureBoot docs for details.

mt7902-dkms

Create driver for MT7902 by cloning the MT9721 driver from the kernel and modifying it.

Motivation

keepsoftware/mt7902-dkms#2

Status

As of now, the code is purely the driver for the mt7921, with just string replacement from mt7921 to mt7902 even in filenames. The code builds with DKMS, but loading of the modules and further is untested yet.

Requirements

• Best tested against the Ubuntu Mainline Kernel v6.8 or greater installed on Ubuntu 24.04 (Noble Numbat)

• sudo apt install dkms should cover all the requirements to test this on ubuntu/debian systems. I'm out of touch with Rocky/Alma/Fedora and cousins.

Usage instructions

• (One time setup) Clone this repo into /usr/src/mt7902:

  sudo git clone https://github.com/samveen/mt7902-dkms /usr/src/mt7902
  

• Create a link to the source dir with a version number(easier versioned driver updates):

  sudo ln -s /usr/src/mt7902 /usr/src/mt7902-0.0.1
  

• Register the module with DKMS(for a specific kernel version, add -k $KVER):

  sudo dkms add --verbose -m mt7902 -v 0.0.1
  

• Build and install the module(for a specific kernel version, add -k $KVER):

  sudo dkms build --verbose -m mt7902 -v 0.0.1
  sudo dkms install --verbose -m mt7902 -v 0.0.1
  

• Check status:

  sudo dkms status --verbose -m mt7902 -v 0.0.1
  

• Get rid of this setup in case it's a pain:

  sudo dkms uninstall --verbose -m mt7902 -v 0.0.1
  sudo dkms remove --verbose -m mt7902 -v 0.0.1 --all
  sudo rm -fR /usr/src/mt7902\*
  

• Firmware download/install - Downloaded from Acer website and installed into /lib/firmware/mediatek/

  cd firmware
  sudo bash -x get-firmware.sh
  

• Update source

  cd /usr/src/mt7902 && sudo git pull
  

PCI ID details

• https://wikidevi.wi-cat.ru/MediaTek_MT7902_Reference_Design
• Windows driver inf contents as sources from link in firmware/acer.url

Firmware

Initial firmware source is the acer website URL for the mt7902 windows driver. This needs to be clarified, as it's proprietary.

License

• For licensing information of the source, please see https://github.com/torvalds/linux/
• For licensing information of firmware, there is no firmware in this repo.
• The contents of URL locations in firmware/ that are owned by their respective owners. Visit their websites for licensing information.