Leírás
A GY-271 (QMC5883L) mágnesesség/iránytű szenzor háromtengelyű digitális magnetométer modul I2C csatolóval. Arduino, ESP32, ESP8266, Raspberry Pi vagy ESPHome alapú rendszerekben használható iránybecslésre, mágneses tér változásának mérésére és robotikai tájolási feladatokra.
A lényeg: ez a modul nem egyszerűen “GY-271”, hanem QMC5883L alapú változat. A szoftver kiválasztásánál ezért nem elég a panelnevet nézni, a DA5883 vagy DB5883 chipfelirat és az I2C cím ellenőrzése is számít.
Működés
A GY-271 panelnév régebben sokszor HMC5883L modult jelentett, de a piacon több QMC-változat is megjelent ugyanilyen vagy nagyon hasonló panelen. A GY-271 (QMC5883L) mágnesesség/iránytű szenzor DA5883 vagy DB5883 jelölésű QMC5883L chipre épül, ezért QMC5883L-hez való könyvtárral kell használni.
Ez a különbség nem csak névleges. A HMC5883L és a QMC5883L regisztertérképe, adatkiolvasási sorrendje és gyakran az I2C címe is eltér. Ha HMC5883L példakódot töltesz fel hozzá, a modul könnyen nem válaszol, nullákat ad, vagy zavaros értékeket küld.
Mi ez egy mondatban?
A GY-271 (QMC5883L) mágnesesség/iránytű szenzor I2C buszos, háromtengelyű mágneses tér érzékelő modul, amely a Föld mágneses terének irányából számítható tájolási adatot ad, megfelelő kalibrálás és zavarszegény beépítés mellett.
Így működik a gyakorlatban
A modul az X, Y és Z tengely mentén méri a mágneses tér komponenseit. A mikrokontroller I2C buszon olvassa ki az adatokat, majd a program ebből számíthat irányszöget vagy nyers mágneses tér értéket.
A GY-271 (QMC5883L) mágnesesség/iránytű szenzor használatakor a beépítés legalább annyira számít, mint a kód. A modul közelében lévő motor, hangszóró, mágnes, nagyáramú vezeték, csavar vagy acél szerkezeti elem elhúzhatja a mérést. Iránytűként használva érdemes kalibrációs rutint futtatni, és a modult a végleges beépítési helyén ellenőrizni.
A tápellátás moduloldalon 3.3 V és 5 V körüli rendszerekhez is használható, de az I2C logikai szintet mindig a konkrét panel és vezérlő együttese alapján ellenőrizd. ESP32 és Raspberry Pi mellett különösen érdemes figyelni arra, hogy a busz 3.3 V-os logikai szinten maradjon.
Tipikus helyzetek, ahol beválik
A GY-271 (QMC5883L) mágnesesség/iránytű szenzor jól használható például:
- robotjármű tájolási segédszenzoraként,
- Arduino alapú digitális iránytűként,
- ESP32 vagy ESP8266 adatgyűjtőben mágneses tér változásának figyelésére,
- ESPHome rendszerben mágneses tér és heading érték mérésére,
- GPS mellé iránybecslési kiegészítésként lassú mozgásnál vagy álló helyzetben,
- oktatási méréshez, ahol az I2C busz és a szenzoradatok kiolvasása a cél,
- mágnes közeledésének vagy vas tárgyak hatásának kísérleti vizsgálatához.
Mire kell figyelni beüzemeléskor?
| Mire figyelj? | Mit okoz? |
|---|---|
| DA5883 vagy DB5883 felirat van a chipen? | QMC5883L könyvtár kell hozzá, nem HMC5883L példakód. |
| I2C scanner mit talál, 0x0D vagy 0x1D címet? | A programban ezt a címet kell beállítani, különben a modul nem válaszol. |
| 3.3 V-os vezérlővel használod? | Ellenőrizni kell, hogy az I2C felhúzások nem húzzák-e 5 V-ra az SDA és SCL vonalat. |
| Motor, mágnes vagy nagyáramú vezeték mellett lesz? | Az irányérték elcsúszhat, ugrálhat vagy teljesen használhatatlanná válhat. |
| Végleges helyén kalibrálod? | Más pozícióban végzett kalibráció után a beépített mérés pontatlan lehet. |
| HMC5883L könyvtárat használsz hozzá? | Tipikus hiba: nincs adat, nulla érték vagy értelmetlen tengelyadat jelenik meg. |
| ESPHome alatt használod? | A qmc5883l platformot és a megfelelő I2C címet kell választani. |
Döntés előtt ellenőrizendő adatok
Vásárlás vagy beépítés előtt ezeket nézd meg:
- A projektedben QMC5883L támogatású könyvtárat tudsz-e használni.
- A vezérlőd I2C lábkiosztása és logikai szintje illeszkedik-e a modulhoz.
- Van-e a környezetben erős mágneses zavarforrás, például motor, relé, hangszóró vagy nagyáramú vezeték.
- Iránytűként elég-e a mágneses tájolás, vagy gyors mozgásnál IMU, gyorsulásmérő és giroszkóp is kell.
- A mechanikai elhelyezésnél biztosítható-e, hogy a modul fixen álljon és ne mozduljon el a kalibráció után.
- A szoftverben kezelhető-e a 0x0D vagy 0x1D I2C cím, ha a modul ilyen változatként jelentkezik.
Fontos korlátok, amikkel számolni kell
- Ne ezt válaszd, ha nagy pontosságú ipari iránymérésre vagy hitelesített mérésre van szükség.
- Ne ezt válaszd önmagában, ha gyorsan mozgó jármű dőlését és forgását is mérni kell, mert ehhez giroszkóp és gyorsulásmérő is kell.
- Ne ezt válaszd olyan helyre, ahol állandóan változó mágneses zavarok vannak, például motorok vagy nagyáramú vezetékek közvetlen közelébe.
- Ne HMC5883L példakódhoz vedd meg, ha a meglévő szoftvered nem módosítható QMC5883L regiszterkezelésre.
- Ne várj stabil irányadatot kalibráció nélkül, különösen akkor, ha a modult már beépített szerkezetben használod.
Egy apró tipp a gyakorlatból
A GY-271 moduloknál az első mérés előtt mindig futtass I2C scannert. Ha 0x0D vagy 0x1D címet látsz, QMC irányban indulj el; ha 0x1E jelenik meg, az már más chipváltozatra utal. Ezzel sok hibakeresési kört meg lehet spórolni.
Műszaki jellemzők
| Jellemző | Érték |
|---|---|
| Szenzorchip: | QMC5883L, DA5883 vagy DB5883 jelölésű változat |
| Érzékelés: | 3 tengelyű mágneses tér mérés |
| Kommunikáció: | I2C, SDA és SCL vonallal |
| I2C cím: | 0x0D vagy 0x1D változattól függően |
| HMC5883L kompatibilitás: | Nem regiszterszintű kompatibilis, QMC5883L könyvtár szükséges |
| Modul tápfeszültség: | 3.3-6 V |
| Chip tápfeszültség adatlap szerint: | 2.16-3.6 V |
| ADC felbontás: | 16 bit |
| Mágneses tartomány: | QST chipadat szerint ±8 Gauss, szoftveres beállításban gyakran 2 vagy 8 Gauss, illetve 200 vagy 800 µT |
| Adatsebesség: | 10, 50, 100 vagy 200 Hz szoftveres beállítástól függően |
| Túlmintavételezés: | 64x, 128x, 256x vagy 512x |
| Iránybecslési pontosság: | 1-2 fok körüli érték megfelelő környezetben és kalibrálással |
| Kivezetések: | VCC, GND, SDA, SCL, DRDY |
| Panelméret: | kb. 15 x 14 mm |
| Tüskesor osztás: | 2.54 mm |
Dokumentáció
- e‑Gizmo műszaki leírás (TECHNICAL MANUAL rev.1) [e-gizmo.net]
- GitHub példatár – e‑Gizmo / QMC5883L‑GY‑271 [GitHub]
- ESPHome platform: qmc5883l specifikáció és példa konfiguráció [ESPHome]
- Arduino fórum – HMC vs QMC regiszterek, byte‑order eltérések [Parallax]
- Tutorialok: Arduino kapcsolódás, i2c‑escanner trükk [SURTR TECHNOLOGY]
- GY-273 (QMC5883L) iránytűszenzor mintakódok, manual
- QMC5883L adatlap
- A FastIMU Arduino library ideális a teszteléshez!
Csomag
- 1 db GY-271 (QMC5883L) mágnesesség/iránytű szenzor modul
- 1 db 5 tűs tördelhető tüskesor
Értékelések
Még nincsenek értékelések.