🥇Sõbrustame RaspberryPi ja TP-Link TL-WN727N

Tere, Habr!

Mõtlesin, et ühendan oma malinka internetiga juhtmevabalt.

Nii see sai teoks, ostsin lähimast poest USB Wi-Fi dongli tuntud firma TP-Linki tootemargiga. Ütlen kohe, et see ei ole mingi nano USB moodul, vaid üsna korralik seade, suuruselt umbes nagu tavaline mälupulk (või kui soovite, siis nagu täiskasvanud mehe keskmine sõrm). Enne ostmist uurisin natuke, millised tootjad toetavad RPI-d ning TP-Link oli nimekirjas (kuigi hiljem selgus, et ma ei arvestanud kõiki nüansse, sest nagu teada, peitub kurat detailides). Nii algab mu külm jutt mu hädade kohta, teie tähelepanu all on detektiivjutt 3 osas. Huvi tundnud palun allapoole.

Artikkel Ühendame WiFi-adapteri WN727N Ubuntu/Mint süsteemiga aitas osaliselt, aga kõik õigeks ajaks.

Ülesande tingimused

Antud:

üheplaadine arvuti Raspberry Pi 2 B v1.1 — 1 tükk
USB Wi-Fi dongel WN727N — 1 tükk
paar mitte päris kõveraid käsi — 2 tükki
operatsioonisüsteemiks on viimase versiooni Raspbian (Debiani 10 Buster baasil)
tuumaversioon 4.19.73-v7+

Leidke: saavutada ühendus internetiga (Wi-Fi tuleb kodusest ruuterist)

Pärast adapteri lahti pakkimist loen juhendit seest:

Süsteemi ühilduvus: Windows 10/8/7/XP (isegi XP) ja MacOS 10.9-10.13

Hmm, Linuxist ei olnud nagu tavaliselt sõnagi. Aastal 2019 oli ikka veel vaja draivereid käsitsi kokku panna...

Meil oli kaasas 2 kompilaatorit, 75 tuhat raamatukogu, viis binaarset blob'i, pool tusside rida logoga ja terve meri pealkirju kõikidest keeltest ja märgistuskeeltest. See ei olnud otseselt vajalik komplekt tööks. Kuid kui oled juba alustanud süsteemi koostamist enda jaoks, on raske peatuda. Ainus, mis mind murelikuks tegi, olid Wi-Fi draiverid. Pole midagi abitumat, vastutustundetumat ja rikutumat kui draiverite kokkupanek lähtekoodidest. Kuid ma teadsin, et varem või hiljem jõuame me ka selle jama juurde.

Üldiselt on teada, et USB Wi-Fi-ga mässamine Linuxis on valus ja natuke maitsev (nagu vene sushi).

Karbis on veel CD-disk draiveritega. Ilma eriliste lootusteta vaatan, mis seal on — täpselt, nad ei ole hoolitsenud. Internedi otsing suunas mind tootja kodulehele, kuid seal oli Linuxi draiver ainult seadme rev. jaoks v4, aga mul oli käes v5.21. Ja ja vanematele tuumaversioonidele 2.6-3.16. Pettunud ebaõnnestumise tõttu juba alguses, mõtlesin, et oleks pidanud valima TL-WN727N (see on veidi kallim ja toetab 300Mbps, võrreldes 150Mbps minu omaga, kuid nagu selgus, ei ole see Raspberri jaoks üldse oluline, sellest kirjutatakse hiljem). Kuid mis kõige tähtsam, juhtmed selle jaoks juba olemas ja neid on lihtne installida paketina. firmware-ralink. Seadme revideerimist saab tavaliselt vaadata seadme korpuselt, kleebiselt koos seerianumbriga.

Edasi otsimine ja erinevate foorumite külastamine ei toonud eriti head tulemust. Tundub, et enne mind ei olnud keegi sellist adapterit Linuxiga ühendamas. Jah, mul on tõeliselt vedanud nagu uppuja.

Kuid ei, valetasin, foorumite külastamine (peamiselt ingliskeelsed) andis siiski tulemusi, mõnes arutelus mainiti isikut lwfinger, kes on tuntud oma WiFi adapterite draiverite kirjutamise poolest. Tema GitHubi hoidla on artikli lõpus linkides. Ja teine õppetund, mille ma sain — on vajalik oma seadme tuvastamine, et mõista, milline draiver sellele sobib.

Osa 1. Tuvastamine

Seadet porti ühendades ei süttinud ükski LED. Ja üldse ei ole aru saada, kas midagi töötab või mitte.

Esimese asjana, et väljas selgitada, kas tuum näeb meie seadet, vaatan dmesg'i:

[  965.606998] usb 1-1.3: uus kõrgkiirus USB seade number 9 kasutades dwc_otg
[  965.738195] usb 1-1.3: Uus USB seade leitud, idVendor=2357, idProduct=0111, bcdDevice= 0.00
[  965.738219] usb 1-1.3: Uued USB seadme stringid: Mfr=1, Toode=2, Seerianumber=3
[  965.738231] usb 1-1.3: Toode: 802.11n NIC
[  965.738243] usb 1-1.3: Tootja: Realtek
[  965.738255] usb 1-1.3: Seerianumber: 00E04C0001

Selgus, et näeb, ja isegi on selge, et seal on Realteki chip ja seadme VID/PID USB bussil.

Liikuda edasi, vaatame lsusb, ja siin ootab meid järgmine ebaõnnestumine

Bus 001 Device 008: ID 2357:0111 
Bus 001 Device 003: ID 0424:ec00 Standard Microsystems Corp. SMSC9512/9514 Fast Ethernet Adapter
Bus 001 Device 002: ID 0424:9514 Standard Microsystems Corp. SMC9514 Hub
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

Süsteem ei tea, mis seadmega on tegu, ja häbenedes kuvab nime asemel tühja kohta (kuigi tootja=2357 on kindlasti TP-Link).

Selle etapi jooksul on uudishimuliku lugeja ilmselt juba märganud midagi huvitavat, kuid jätame selle hilisemaks.

Probleemi uurimine tühjade nimedega viis mind lehe juurde, kus on loetletud tuntud VID/PID. Meie 2357:0111 seal ei olnud. Hiljem selgus, et utiliit lsusb kasutab faili /usr/share/misc/usb.ids, mis on sama identifikaatorite loend sellelt veebisaidilt. Ilusa kuvamise jaoks lisasin lihtsalt oma süsteemi ridade jaoks TP-Linki müüjalt.

2357  TP-Link
        0111  TL-WN727N v5.21

Nii et seadmete loendis parandasime kuvamist, kuid see ei aidanud meid juhendite valimisel sammukestki edasi. Juhendi valimiseks tuleb teada, millisel kiibil su adapter on tehtud. Järjekordsed tulutud katsed Internetis seda teada saada ei viinud headeni. Varustades end peene Phillipsi kruvikeerajaga, tõstan ettevaatlikult adapteri katte ja minu silmade ette avanes kogu oma algses paletuses onu Liao patune lapsuke. Luubi all on võimalik kiibi nimi näha — RTL8188EUS. See on juba hea. Mõnedes foorumites olen näinud postitusi, et sellele kiibile sobib näiteks see juhend, mille on kirjutanud härra lwfinger (isegi kui tal on kirjas ainult RTL8188EU kohta).

Osa 2. Borna ülevus

Laen juhendi allikaid gitist.

On aeg Windows uuesti installida ja tegeleda sellega, mida tavaliselt seostatakse Linuxi kasutajatega – midagi allikast kokku panema. Juhendite kokkupanek osutub olevat vähe erinev programmide kompileerimisest:

make
sudo make install

aga tuumamoodulite kompileerimiseks vajame meie konkreetse versiooni jaoks tuuma päiseid.

Defaults-repositooriumis on pakett raspberrypi-kernel-headers, kuid see sisaldab failide versiooni tuumale 4.19.66-v7l+, ja see ei sobi meile. Kuid vajalikku versiooni päiste saamiseks, nagu selgub, on mugav tööriist rpi-source (link lõpuks GitHubis), millega saab alla laadida vajalikud päised. Kloonime repositoorsiumi, teeme skripti täidetavaks, käivitame. Esimene käivitamine ebaõnnestub veaga — utiliiti pole. bcÕnneks on see repositooriumis ja me lihtsalt installime selle.

sudo apt-get install bc

Pärast seda, kui uuesti käivitame ja päiste laadimine (ja hiljem millegi seadistamine, seda ma enam ei mäleta) võtab aega ning võib tagasi eemalduda tooli seljatoele, Windows on igas oma väljenduses parem.

Pärast seda, kui kõik päised on alla laaditud, kontrollime, et kataloog on olemas /lib/modules/4.19.73-v7+ ning seal on sümboolne link, mis osutab kohtadele, kus alla laaditud failid asuvad (minu puhul see on /home/pi/linux):

pi@raspberrypi:/home/pi/rtl8188eu# ls -l /lib/modules/4.19.73-v7+/
lrwxrwxrwx  1 root root     14 Sep 24 22:44 build -> /home/pi/linux

Valmistusprosessin vaihe on ohitettu, voimme aloittaa kokoamisen. Modulien kokoaminen vie taas hieman aikaa, Raspberry Pi ei ole nopein laite (sen prosessori on 32-bittinen 900 MHz Cortex ARM v7).
Niin, kaikki on käännetty. Asennamme ajurin toisessa vaiheessa (make install), samalla kopioidaan myös muita ajurille tarvittavia firmware-tiedostoja:

install:
        install -p -m 644 8188eu.ko  $(MODDESTDIR)
        @if [ -a /lib/modules/$(KVER)/kernel/drivers/staging/rtl8188eu/r8188eu.ko ] ; then modprobe -r r8188eu; fi;
        @echo "blacklist r8188eu" > /etc/modprobe.d/50-8188eu.conf
        cp rtl8188eufw.bin /lib/firmware/.
        /sbin/depmod -a ${KVER}
        mkdir -p /lib/firmware/rtlwifi
        cp rtl8188eufw.bin /lib/firmware/rtlwifi/.

Osa 3. Bornin uhka

Laitan tikun porttiin ja… mitään ei tapahdu. Onko kaikki tämä ollut turhaa?

Aloin tutkia projektin tiedostoja ja löysin yhdestä niistä ongelman syyn: ajurissa on määritelty täydellinen luettelo käytettävissä olevista VID/PID-tunnisteista. Jotta laitteeni toimisi tämän ajurin kanssa, lisäsin vain oman id:ni tiedostoon rtl8188eu/os_dep/usb_intf.c

static struct usb_device_id rtw_usb_id_tbl[] = {
        /*=== Realtek demoboard ===*/
        {USB_DEVICE(USB_VENDER_ID_REALTEK, 0x8179)}, /* 8188EUS */
        {USB_DEVICE(USB_VENDER_ID_REALTEK, 0x0179)}, /* 8188ETV */
        /*=== Customer ID ===*/
        /****** 8188EUS ********/
        {USB_DEVICE(0x07B8, 0x8179)}, /* Abocom - Abocom */
        {USB_DEVICE(0x0DF6, 0x0076)}, /* Sitecom N150 v2 */
        {USB_DEVICE(0x2001, 0x330F)}, /* DLink DWA-125 REV D1 */
        {USB_DEVICE(0x2001, 0x3310)}, /* Dlink DWA-123 REV D1 */
        {USB_DEVICE(0x2001, 0x3311)}, /* DLink GO-USB-N150 REV B1 */
        {USB_DEVICE(0x2001, 0x331B)}, /* D-Link DWA-121 rev B1 */
        {USB_DEVICE(0x056E, 0x4008)}, /* Elecom WDC-150SU2M */
        {USB_DEVICE(0x2357, 0x010c)}, /* TP-Link TL-WN722N v2 */
        {USB_DEVICE(0x2357, 0x0111)}, /* TP-Link TL-WN727N v5.21 */
        {}      /* Terminating entry */
};

Käänsin ajurin uudelleen ja asensin sen taas järjestelmään.

Ja tällä kertaa kaikki toimi. Adapterin valo syttyi ja verkkoliittymäluettelossa ilmestyi uusi laite.

Langattomien liitäntöjen tarkastelu antaa seuraavat tiedot:

pi@raspberrypi:/home/pi/rtl8188eu# iwconfig
eth0      ei langattomia laajennuksia.

lo        ei langattomia laajennuksia.

wlan0     ei yhdistetty  ESSID:""  Nimi:""
          Tila:Automaattinen  Taajuus=2.412 GHz  Pääsykohta: Ei-yhdistetty   
          Herkkyys:0/0  
          Uusintayritys:ei   RTS thr:ei   Fragmentointi thr:ei
          Salausavain:pois käytöstä
          Virrankäyttöhallinta:pois käytöstä
          Linkin laatu=0/100  Signaalitason taso=0 dBm  Melutason taso=0 dBm
          Rx virheelliset nwid:0  Rx virheelliset kryptot:0  Rx virheelliset fragmentit:0
          Tx liiallisia yrityksiä:0  Virheellisiä muita:0   Ohitettu beacon:0

Bonusta niille, jotka lukivat loppuun

Muistatko, mitä sanoin siitä, ettei ole väliä, mikä on ilmoitettu maksiminopeus adapterillesi?
Nii et, Raspberries (enne mudeli 4 väljumist) on kõik seadmed (sealhulgas etherneti adapter) seotud ühe usb sõiduteega. Suurepärane, eks? Ja seetõttu jaguneb usb sõidutee läbilaskevõime kõigi seadmete vahel. Kiiruseteste tehes - nii etherneti kui ka usb wi-fi kaudu (ühendatud ühe ruuteriga) - õhus ja juhtmega, näitas see umbes 20 Mbit/s.

P.S. Tegelikult kehtib see juhend selle konkreetse adapteri draiveri kompileerimiseks mitte ainult RPI puhul. Kordasin seda ka oma lauaarvutis Linux Mintiga - seal töötas samuti kõik. Lihtsalt peate täpselt sama, et alla laadida õiged päisefailid oma kasutatava kerneli versiooni jaoks.

UPD. Teadlikud inimesed soovitasid: et mitte sõltuda kerneli versioonist, tuleks draivereid koguda ja installida dkms abil. README failis on ka see variant.

pi@raspberrypi:/home/pi# sudo dkms add ./rtl8188eu
pi@raspberrypi:/home/pi# sudo dkms build 8188eu/1.0
pi@raspberrypi:/home/pi# sudo dkms install 8188eu/1.0

UPD2. Ettepanek patš seadme ID võeti laiemasse haru lwfinger/rtl8188eu hoidlast.

Viidatud lingid
— RPi USB Wi-Fi adapterid
— GitHub lwfinger/rtl8188eu
— usb.ids
— rpi-source

Allikas: habr.com