Enstriksyon: AIR RASPBERRY Pi
KI KONSEYE POU FRANBOZ PI 400. KONPATIB AK Franbwaz PI 2, 3 AK 4.
V1d
ENTWODIKSYON
MonkMakes Air Quality Twous pou Raspberry Pi baze sou tablo MonkMakes Air Quality Sensor. Add-on sa a pou Franbwaz Pi a mezire kalite lè a nan yon chanm (ki jan lè a rasi) ak tanperati a. Tablo a gen yon ekspozisyon sis LED (vèt, zoranj ak wouj) ki montre bon jan kalite lè a ak yon buzzer. Raspberry Pi ou a kapab li lekti tanperati ak bon jan kalite lè a, epi buzzer la ak ekspozisyon ki ap dirije yo ka kontwole tou nan Raspberry Pi ou.
Komisyon Konsèy Air Quality Sensor, ploge dirèkteman nan do a nan yon Franbwaz Pi 400, men, yo ka itilize tou ak lòt modèl nan Franbwaz Pi, lè l sèvi avèk fil kavalye yo ak modèl GPIO ki enkli nan twous la. 
PATI
Tanpri sonje ke yon Franbwaz Pi PA enkli nan twous sa a.
Anvan ou fè nenpòt lòt bagay, tcheke si twous ou a gen ladan atik ki anba yo.
KALITE AIR AK ECO2
Tablo Air Quality Sensor itilize yon Capteur ak yon nimewo pati nan CCS811. Ti chip sa a pa aktyèlman mezire nivo CO2 (diyoksid kabòn) men pito nivo yon gwoup gaz ki rele konpoze òganik temèt (VOC). Lè andedan kay la, nivo gaz sa yo monte nan yon vitès ki sanble ak CO2, epi se poutèt sa yo ka itilize pou estime nivo CO2 (ki rele CO2 ekivalan oswa eCO2).
Nivo CO2 nan lè nou respire a gen yon enfliyans dirèk sou byennèt nou. Nivo CO2 yo nan yon enterè patikilye nan yon pwen sante piblik nan view kòm, pou mete li tou senpleman, yo se yon mezi ki kantite nou ap respire lè lòt moun. Nou moun respire CO2 e konsa, si plizyè moun nan yon chanm mal ayere, nivo CO2 ap ogmante piti piti. Sa a se menm jan ak aerosol viral ki gaye rim sèvo, grip ak kowonaviris lè moun yo respire tou de ansanm.
Yon lòt enpak enpòtan nan nivo CO2 se nan fonksyon mantal - ki jan byen ou ka panse. Etid sa a (pami anpil plis) gen kèk rezilta enteresan. Sitasyon sa a soti nan Sant Nasyonal pou Enfòmasyon sou Bioteknoloji nan USA a: "nan 1,000 ppm CO2, dekresyon modere ak estatistik enpòtan ki te fèt nan sis nan nèf echèl nan pèfòmans pran desizyon. Nan 2,500 ppm, rediksyon gwo ak estatistik enpòtan ki te fèt nan sèt echèl pèfòmans nan pran desizyon "Sous: https://www.ncbi.nlm.nih.gov/pmc/articles/PMC3548274/
Tablo ki anba a baze sou enfòmasyon ki soti nan https://www.kane.co.uk/knowledge-centre/whatare-safe-levels-of-co-and-co2-in-rooms
epi montre nivo ki CO2 ka vin malsen. Lekti CO2 yo an ppm (pati pa milyon).
| Nivo CO2 (ppm) | Nòt |
| 250-400 | Konsantrasyon nòmal nan lè anbyen. |
| 400-1000 | Konsantrasyon tipik nan espas andedan kay okipe ak bon echanj lè. |
| 1000-2000 | Plent somnolans ak lè pòv. |
| 2000-5000 | Maltèt, dòmi ak stagnan, rasi, lè bouche. Move konsantrasyon, pèt atansyon, ogmante batman kè ak ti kè plen ka prezan tou. |
| 5000 | Limit ekspoze nan espas travay nan pifò peyi yo. |
| > 40000 | Ekspozisyon ka mennen nan privasyon oksijèn grav ki lakòz domaj pèmanan nan sèvo, koma, menm lanmò. |
ENFÒMASYON
Si w ap itilize yon Franbwaz Pi 400 oswa yon Franbwaz Pi 2, 3 oswa 4, asire w ke Franbwaz Pi a fèmen epi li koupe pouvwa anvan ou konekte Capteur Kalite lè a.
Capteur Kalite lè a pral montre lekti eCO2 yo le pli vit ke li jwenn pouvwa nan Raspberry Pi ou a. Se konsa, yon fwa ou te konekte li, ekspozisyon an ta dwe endike nivo eCO2 la. Lè sa a, ou pral aprann ki jan yo kominike avèk tablo a, resevwa lekti ak kontwole LED yo ak buzzer nan yon pwogram Python.
Konekte Capteur Kalite lè a (Raspberry Pi 400)
Li trè enpòtan pou ou pa pouse konektè a nan yon ang, oswa pouse li twò difisil, paske ou ka pliye broch yo sou konektè GPIO la. Lè broch yo aliyen
kòrèkteman, li ta dwe pouse an plas fasil.
Konektè a adapte jan yo montre pi wo a. Remake ke kwen anba nan tablo a liy ak anba a nan ka Pi 400 a, ak bò a nan tablo a kite jis ase plas pou aksè fasil nan kat mikwo SD la. Yon fwa ou fin konekte tablo a, pouvwa moute Franbwaz Pi ou. — tou de dirije pouvwa a (nan logo MonkMakes la) ak youn nan LED eCO2 yo ta dwe tou limen.
Konekte Capteur Kalite lè a (Raspberry Pi 2/3/4)
Si ou gen yon Franbwaz Pi 2, 3, 4, Lè sa a, w ap bezwen Franbwaz Leaf la ak kèk fil kavalye fi ak gason pou konekte tablo a Air Quality Sensor ak Franbwaz Pi ou a.
AVÈTISMAN: Ranvèse fil kouran yo oswa konekte Capteur Kalite lè a nan 5V olye ke PIN 3V nan Franbwaz Pi a gen chans rive nan kraze Capteur a epi li ka domaje Franbwaz Pi ou a. Se konsa, tanpri tcheke fil elektrik la ak anpil atansyon anvan ou alimante sou Franbwaz Pi ou a.
Kòmanse pa mete fèy Franbwaz la sou broch GPIO Franbwaz Pi ou a pou ou ka di ki PIN ki. Modèl la ka anfòm nenpòt fason, kidonk asire w ke ou swiv dyagram ki anba a. 
Apre sa, ou pral konekte kat kondwi ant broch GPIO Raspberry Pi a ak tablo Kalite lè a tankou sa a:
| Franbwaz Pi Pin (tankou ki make sou fèy la) | Komisyon Konsèy Kalite lè a (tankou ki make sou konektè) | Koulè fil sijere. |
| GND (nenpòt pin ki make GND ap fè) | GND | Nwa |
| 3.3V | 3V | Wouj |
| 14 TXD | PI_TXD | Orange |
| 15 RXD | PI_RXD | Jòn |
Yon fwa li tout konekte, li ta dwe sanble sa a:
Tcheke fil elektrik ou a ak anpil atansyon epi apresa mete kouran Raspberry Pi ou a - tou de dirije pouvwa a (nan logo MonkMakes la) ak youn nan LED yo ta dwe tou limen.
Debranche Komisyon Konsèy Kalite lè a
Anvan ou retire tablo a nan yon Raspberry Pi 400.
- Fèmen Franbwaz Pi a.
- Dousman soulaje tablo a nan do Pi 400 la, kwen li yon ti kras nan chak bò nan vire, pou yo pa pliye broch yo.
Si ou gen yon Pi 2/3/4 jis retire fil kavalye yo nan Franbwaz Pi a.
Pèmèt entèfas seri a
Menm si tablo a pral montre nivo eCO2 san okenn pwogramasyon, sa vle di nou jis itilize Franbwaz Pi a kòm yon sous pouvwa. Pou kapab kominike avèk tablo a nan yon pwogram Python, sou Franbwaz Pi nou an, gen kèk etap plis ke nou bezwen pran.
Premye a se pèmèt koòdone nan seri sou Franbwaz Pi a, kòm li se koòdone sa a ki itilize pa tablo a Kalite lè.
Pou fè sa, chwazi Preferans ak Lè sa a Franbwaz Pi Konfigirasyon nan meni prensipal la.
Chanje nan tab la Entèfas epi asire w ke Serial Port aktive epi Serial Console enfim.
Telechaje ExampPwogram yo
Ansyen anampPwogram pou twous sa a disponib pou telechaje nan GitHub. Pou jwenn yo, kòmanse yon fenèt navigatè sou Franbwaz Pi ou a epi ale nan adrès sa a:
https://github.com/monkmakes/pi_aq Telechaje yon achiv postal pwojè a lè w klike sou bouton Kòd la epi klike sou opsyon Download ZIP la.
Yon fwa telechaje a fini, ekstrè a files soti nan achiv postal la lè w jwenn ZIP la file nan katab Downloads ou a ak Lè sa a, klike sou dwa sou li epi chwazi opsyon nan Ekstrè Pou.
Chwazi yon anyè apwopriye (mwen ta rekòmande anyè lakay ou - /home/pi) epi ekstrè la files. Sa a pral kreye yon katab ki rele pi_aq-main. Chanje non sa a jis pi_aq.
Thonny
Èske w gen telechaje pwogram yo, ou ta ka jis kouri yo soti nan liy lan lòd.
Sepandan, li bon pou w gade nan files, ak editè Thonny a pral pèmèt nou edite a files ak kouri yo.
Editè Thonny Python pre-enstale nan Raspberry Pi OS. Ou pral jwenn li nan seksyon Programming nan meni prensipal la. Si pou nenpòt rezon li pa enstale sou ou
Franbwaz Pi, Lè sa a, ou ka enstale li lè l sèvi avèk opsyon nan meni Ajoute / Retire lojisyèl sou atik nan meni Preferans.
Pwochen seksyon an eksplike yon ti jan plis sou sa Capteur sa a ap mezire, anvan nou antre nan kominike avèk tablo Kalite lè lè l sèvi avèk Python ak Thonny.
KÒMANSE
Anvan nou kòmanse pwogramasyon Python, ann gade sou Konsèy Kalite lè a.
Endikatè pouvwa a ki ap dirije nan tèt gòch la, bay yon chèk rapid ke tablo a ap resevwa pouvwa. Anba sa a se yon chip Capteur tanperati, ak akote sa a se chip Capteur eCO2 tèt li. Si w gade byen nan li, w ap wè ke li gen ti twou pou lè a antre ak soti. Dirèkteman anba Capteur eCO2 a se yon buzzer, ke ou ka limen ak koupe nan pwogram ou yo. Sa itil pou bay alam. Se kolòn nan sis dirije (ki soti anba nan tèt) nan de LED vèt, de LED zoranj ak de LED wouj. Sa yo pral limen lè nivo eCO2 ki make akote chak LED depase. Yo pral montre nivo a le pli vit ke Franbwaz Pi a leve, men ou ka kontwole yo tou lè l sèvi avèk Python.
Ann kòmanse pa eseye kèk eksperyans nan liy lòd la. Louvri yon sesyon Tèminal lè w klike sou ikòn Tèminal ki anlè ekran w la, oswa seksyon Pwodwi pou Telefòn nan meni prensipal la.
Lè tèminal la ouvri, tape kòmandman sa yo apre èd memwa $, pou chanje répertoires (cd) ak pou ouvri yon Python. 
Louvri modil aq lokal la lè w tape kòmandman an: >>> soti nan aq import AQ
>>> Lè sa a, kreye yon egzanp nan klas AQ la pa tape: >>> aq = AQ()
>>> Nou kapab kounye a li nivo CO2 la lè nou tape kòmandman an: >>> aq.get_eco2() 434.0
>>> Se konsa, nan ka sa a, nivo eCO2 a se yon bèl fre 434 ppm. Ann jwenn tanperati a kounye a (an degre Sèlsiyis). >>> aq.get_temp()
20.32 Remak: Si w resevwa mesaj erè lè w ap kouri kòd ki anwo a, ou ka pa enstale GUIZero. Enstriksyon enstalasyon isit la:
https://lawsie.github.io/guizero/#raspberry-pi
PWOGRAM 1. ECO2 METER
Lè w ap kouri pwogram sa a, fenèt ki sanble ak sa ki anba a ap louvri, ki montre w tanperati a ak nivo eCO2. Eseye mete dwèt ou sou Capteur tanperati a epi lekti tanperati yo ta dwe monte. Ou ka respire tou dousman sou Capteur eCO2 a epi lekti yo ta dwe ogmante.
Pou kouri pwogram nan, Chaje la file 01_aq_meter.py nan Thonny epi klike sou bouton Kouri a.
Men kòd pwojè a. Kòd la sèvi ak bibliyotèk GUI Zero ke ou ka li plis sou nan Apendis B.
Pou pèmèt lekti nan tanperati ak limyè yo pran plas san yo pa entèwonp fonksyonman yo nan koòdone itilizatè a, se bibliyotèk la threading enpòte. Fonksyon update_readings pral bouk pou tout tan, pran lekti chak mwatye segonn epi mete ajou jaden yo nan fenèt la.
Rès kòd la bay jaden koòdone itilizatè ki nesesè pou montre tanperati a ak nivo eCO2. Sa yo mete deyò kòm yon gri, se konsa ke jaden yo liy. Se konsa, chak jaden defini ak yon atribi kadriyaj ki reprezante pozisyon kolòn ak ranje. Kidonk, jaden an ki montre tèks Temp (C) se nan kolòn 0, ranje 0 ak valè tanperati ki koresponn lan (temp_c_field) se nan kolòn 1, ranje 0.
PWOGRAM 2. ECO2 METER AK ALARM
Pwogram sa a pwolonje Pwogram yon sèl, lè li sèvi ak buzzer la ak kèk karakteristik koòdone itilizatè anpenpan, fè yon son alam ak fenèt la vin wouj si yon nivo seri eCO2 depase. 
Kurseur ki anba fenèt la fikse nivo eCO2 kote buzzer a ta dwe sonnen epi fenèt la vin wouj. Eseye mete nivo Alam la yon ti kras pi wo pase
aktyèl nivo eCO2 ak Lè sa a, respire sou Capteur a.
Isit la se kòd la pou Pwogram 2, anpil nan li trè menm jan ak Pwogram 1. Zòn nan enterè yo te make nan bold.import threading
tan enpòte
soti nan Guizero enpòte App, tèks, kurseur
soti nan aq enpòte AQ
aq = AQ()
app = Aplikasyon (tit = "Kalite lè", lajè = 550, wotè = 400, layout = "gri")
def update_readings():
alòske se vre: temp_c_field.value = str(aq.get_temp()) eco2 = aq.get_eco2() eco2_field.value = str(eco2)
si eco2 > slider.value: app.bg = "wouj" app.text_color = "blan" aq.buzzer_on ()
lòt bagay: app.bg = "blan" app.text_color = "nwa" aq.buzzer_off () time.sleep (0.5)
t1 = threading.Thread (sib = update_readings)
t1.start() # kòmanse fil ki mete ajou lekti yo aq.leds_automatic()
# defini koòdone itilizatè a
Tèks (aplikasyon, tèks = "Temp (C)", gri = [0,0], gwosè = 20)
temp_c_field = Tèks (aplikasyon, tèks = ”-“, kadriyaj = [1,0], gwosè = 100)
Tèks (aplikasyon, tèks = "eCO2 (ppm)", kadriyaj = [0,1], gwosè = 20)
eco2_field = Tèks (aplikasyon, tèks = ”-“, kadriyaj = [1,1], gwosè = 100)
Tèks (aplikasyon, tèks = "Alam (ppm)", kadriyaj = [0,2], gwosè = 20)
kurseur = Kurseur (app, kòmanse = 300, fen = 2000, lajè = 300, wotè = 40, kadriyaj = [1,2]) app.display ()
Premyèman, nou bezwen ajoute Slider nan lis bagay nou enpòte soti nan guizero.
Nou bezwen tou pou yon ekstansyon pou fonksyon update_readings la, pou ke, osi byen ke montre tanperati a ak nivo eCO2, li tcheke tou pou wè si nivo a pi wo pase papòt la. Si li se, li mete background nan fenèt nan wouj, tèks la nan blan epi li vire buzzer la. Si nivo eCO2 a se pi ba pase papòt la fikse pa kurseur la, li ranvèse sa a, epi vire buzzer la.
PWOGRAM 3. DONE LOGGER
Pwogram sa a (03_data_logger.py) pa gen yon koòdone grafik. Li jis envit ou antre nan yon entèval nan segonn ant lekti, ki te swiv pa non an nan yon file
kote pou konsève pou lekti yo.
Nan ansyen anample pi wo a, sampling se mete sou 5 segonn ak la file yo rele readings.txt. Lè ou fin antre done, CTRL-c pral fini ak fèmen an file.
Done yo sove nan menm fòma jan yo montre nan kaptire ekran an pi wo a. Sa vle di, premye liy lan espesifye tit yo, ak chak valè delimite pa yon karaktè TAB. La file se sove nan menm anyè ak pwogram nan. Lè w te kaptire done yo, ou ka enpòte li nan yon calcul (tankou LibreOffice) sou Franbwaz Pi ou a epi trase yon tablo ki soti nan done yo. Si LibreOffice pa enstale sou Raspberry Pi ou a, ou ka enstale li lè l sèvi avèk opsyon Add/Remove Software nan meni Preferans.
Louvri yon nouvo calcul, chwazi Louvri nan la file meni, epi navige nan done yo file ou vle gade. Sa a pral louvri yon dyalòg enpòte (gade pwochen paj la) ki montre
ke fèy calcul la otomatikman detekte kolòn done yo. 
Klike sou OK pou enpòte done yo, epi chwazi kolòn pou lekti eCO2 yo. Lè sa a, ou ka trase yon graf nan lekti sa yo lè w chwazi Tablo nan meni Insert la, epi apre w chwazi yon kalite Tablo nan Liy, ki te swiv pa Liy Sèlman. Sa a ba ou graf ki montre nan pwochen paj la.
Kòm yon eksperyans, eseye kite pwogram logger la kouri pou yon peryòd 24 èdtan pou wè ki jan nivo eCO2 chanje pandan jounen an.
ANPÈS A. DOKIMANTASYON API
Pou pwogramasyon yo grav - isit la se dokiman an teknik. La file monkmakes_aq.py pa enstale kòm yon bibliyotèk Python konplè, men li ta dwe jis kopye nan katab la menm jan ak nenpòt lòt kòd ki bezwen sèvi ak li. aq.py
Modil monkmakes_aq.py a se yon klas ki vlope kominikasyon seri ant Raspberry Pi ou ak tablo Kalite lè a.
Kreye yon egzanp AQ: aq = AQ()
Lekti lekti eCO2 la
aq.get_eco2() # retounen lekti eCO2 an ppm
Lekti tanperati a an degre C
aq.get_temp() # retounen tanperati a an degre C
Ekspozisyon a dirije
aq.leds_manual() # mete mòd LED nan manyèl
aq.leds_automatic() # mete mòd LED nan otomatik
# pou LED yo montre eCO2
aq.set_led_level(level) # nivo 0-LED yo koupe,
# nivo 1-6 dirije 1 a 6 limen
Buzzer
aq.buzzer_on()
aq_buzzer_off()
Klas la kominike ak tablo Capteur a lè l sèvi avèk koòdone seri Pi a. Si ou vle wè detay sou koòdone seri a, tanpri pran yon gade nan fichye done pou pwodui sa a. Ou pral jwenn yon lyen sa a soti nan pwodwi a web paj (http://monkmakes.com/pi_aq)
ANPÈS B. GUI ZERO
Laura Sach ak Martin O'Hanlon nan Fondasyon Raspberry Pi te kreye yon bibliyotèk Python (GUI Zero) ki fè li trè fasil pou konsepsyon GUIs. Twous sa a sèvi ak bibliyotèk sa a.
Anvan ou ka itilize bibliyotèk la, ou bezwen enpòte ti moso yo ke ou vle itilize nan pwogram ou an.
Pou egzanpample, si nou jis te vle yon fenèt ki gen yon mesaj, isit la nan lòd la enpòte:
soti nan Guizero enpòte App, Tèks
Aplikasyon klas la reprezante aplikasyon an li menm, epi chak pwogram ou ekri ki sèvi ak guizero bezwen enpòte sa a. Sèl lòt klas ki nesesè isit la se Tèks, ki itilize pou montre mesaj la.
Kòmandman sa a kreye fenèt aplikasyon an, ki espesifye yon tit ak dimansyon kòmanse fenèt la.
app = Aplikasyon (tit = "Fenèt mwen an", lajè = "400″, wotè = "300")
Pou ajoute kèk tèks nan fenèt la, nou ka itilize liy lan: Tèks (app, tèks = "Bonjou mond", gwosè = 32)
Fenèt la prepare kounye a pou ekspozisyon, men li pa pral aktyèlman parèt jiskaske pwogram nan kouri liy lan: app.display()
Ou ka jwenn plis enfòmasyon sou guizero isit la: https://lawsie.github.io/guizero/start/
DEPANN
Pwoblèm: Se tablo a ploge nan Pi 400 mwen an men ki ap dirije pouvwa a pa limen.
Solisyon: Tcheke ke broch GPIO yo aliyen kòrèkteman ak priz la. Gade paj 4.
Pwoblèm: Se tablo a ploge nan Pi 400 mwen an men ki ap dirije pouvwa a ap flache rapidman.
Solisyon: Sa a endike yon pwoblèm ak Capteur a. Pafwa, tout sa li bezwen se pou pouvwa a dwe reset pa vire Franbwaz Pi ou a ak sou ankò. Si ou fè sa epi flache a ap kontinye, pwobableman ou gen yon tablo defo, kidonk tanpri kontakte support@monkmakes.com
Pwoblèm: Mwen jis konekte tout bagay, men lekti eCO2 yo sanble mal.
Solisyon: Kalite Capteur yo itilize nan MonkMakes Air Quality Sensor, ap kòmanse pwodwi lekti depi premye fwa ou konekte li. Sepandan, lekti yo ap vin pi egzak ak tan. Fichye done pou Capteur IC a sijere lekti yo pral sèlman kòmanse vin egzat apre 20 minit nan tan kouri.
Pwoblèm: Mwen jwenn mesaj erè lè mwen eseye kouri ansyen anamppwogram yo.
Solisyon: Remak: Ou ka pa enstale GUIZero. Tanpri swiv enstriksyon yo isit la: https://lawsie.github.io/guizero/#raspberry-pi
Pwoblèm: Mwen konpare lekti ki soti nan Capteur sa a ak yon mèt CO2 vre ak lekti yo diferan.
Solisyon: Sa a dwe espere. Air Quality Sensor estime konsantrasyon CO2 (se sa ki 'e' a nan eCO2) lè li mezire nivo konpoze òganik temèt (VOC). Vrè detèktè CO2 yo pi chè.
APRANN
Programmation & Elektwonik
Si ou vle aprann plis sou pwogramasyon Raspberry Pi ak Elektwonik, Lè sa a, designer nan twous sa a (Simon Monk) te ekri yon kantite liv ke ou ta ka jwi.
Ou ka jwenn plis enfòmasyon sou liv Simon Monk nan: http://simonmonk.org oswa swiv li sou Twitter kote li ye @simonmonk2
MONKMAKES
Pou plis enfòmasyon sou twous sa a, paj lakay pwodwi a se isit la: https://monkmakes.com/pi_aq
Osi byen ke twous sa a, MonkMakes fè tout kalite twous ak gadjèt pou ede ak ou
pwojè maker. Jwenn plis enfòmasyon, osi byen ke ki kote yo achte nan: https://www.monkmakes.com/products
Ou ka swiv MonkMakes tou sou Twitter@monkmakes.
Dokiman / Resous
 |
MONK MAKES Air Quality Kit pou Franbwaz Pi [pdfEnstriksyon yo Twous Kalite lè pou Franbwaz Pi, Twous Kalite pou Franbwaz Pi, Twous pou Franbwaz Pi, Franbwaz Pi, Pi |
