
FIRMWARE MOLEGRAPH AUTO (v4.6)
Nvod k nahrn pes USB ve Windows
========================================

Tento balek obsahuje pedkompilovan varianty firmwaru pro koln mic
systm MoleGraph. Firmware b na Arduinu Nano s mikrokontrolrem ATmega328P.

Kvli omezen programov pamti Arduina Nano nabz balek tyi konfigurace
firmwaru. Kad konfigurace je k dispozici jako:

  - standardn soubor .hex pro bn nahrvn pes USB;
  - soubor .with_bootloader.hex pro pokroil programovn pes ISP.

JAK FIRMWARE ZVOLIT?
========================================

NEJSTE SI JIST? Zante variantou 30720 a pouijte piloen USB skript pro
Windows. Automaticky vyzkou odpovdajc rychlosti, take nemuste vdt,
kter bootloader je ve vaem Arduinu Nano nainstalovn.

1. STANDARDN KONFIGURACE - 30720 bajt

Soubor:
MoleGraphAuto-v4.6-30720-NO_LSM303DLHC.hex

TOF dlkomr: VL530X
Vypnuto: akcelerometr a magnetometr LSM303DLHC.

Dobr vchoz volba pro nahrvn pes USB a irokou kompatibilitu.

2. KONFIGURACE VL53L1X - 30720 bajt

Soubor:
MoleGraphAuto-v4.6-30720-VL53L1X-NO_LSM303DLHC-NO_MAX6675-NO_TURB-NO_AD8232-NO_DCA30-NO_LED.hex

TOF dlkomr: VL53L1X
Vypnuto:
  - akcelerometr a magnetometr LSM303DLHC
  - teplotn idlo MAX6675 s termolnkem typu K
  - zkalomr
  - EKG AD8232
  - proudov idlo 030 A
  - vstupn LED modul

Tuto variantu pouijte, pokud potebujete VL53L1X a muste se vejt do
menho pamovho limitu.

3. PLN KONFIGURACE - 32256 bajt

Soubor:
MoleGraphAuto-v4.6-32256.hex

TOF dlkomr: VL530X
Vypnuto: nic  pln konfigurace idel.

Jde o nejplnj pedkompilovanou variantu. Pouijte ji, pokud m vae
Arduino Nano novj bootloader Optiboot a chcete aktivovat vechna dostupn
idla.

4. KONFIGURACE VL53L1X - 32256 bajt

Soubor:
MoleGraphAuto-v4.6-32256-VL53L1X-NO_LSM303DLHC-NO_MAX6675.hex

TOF dlkomr: VL53L1X
Vypnuto:
  - akcelerometr a magnetometr LSM303DLHC
  - teplotn idlo MAX6675 s termolnkem typu K

Tuto variantu pouijte, pokud mte Optiboot, potebujete VL53L1X a chcete
ponechat zapnutch vce idel ne u varianty VL53L1X s limitem 30720 bajt.

VYSVTLEN PAM̍OVCH LIMIT
========================================

sla 30720 a 32256 oznauj pamov limit firmwaru v bajtech. Nejde o
velikost staenho souboru HEX. sti NO_... v nzvu oznauj idla nebo
moduly, kter jsou v dan variant vypnut.

Dostupn programov pam zvis na bootloaderu Arduina Nano:

  - 30720 bajt u starho bootloaderu;
  - 32256 bajt u novjho bootloaderu Optiboot.

Pokud si nejste jist, zvolte variantu 30720 a nahrajte ji pomoc USB skript.
Varianta 32256 vyaduje Optiboot.

Nvod na instalaci Optibootu a nastaven pojistek najdete zde:
https://github.com/e-Mole/MoleGraph/blob/master/docs/troubleshooting/02_arduino-nano-bootloader-fix.md

WINDOWS: NEJJEDNODU NAHRN FIRMWARU PES USB
========================================

Balek obsahuje AVRDUDE a pipraven skripty .bat pro Windows. Nen nutn
instalovat AVRDUDE samostatn ani run zadvat pkazy.

Pi rozbalovn zachovejte vechny sloky a soubory.

1. Rozbalte cel balek do sloky v potai. Vechny soubory a podsloky
   ponechte pohromad.
2. Pipojte Arduino Nano k potai datovm USB kabelem.
3. V hlavn sloce balku dvakrt kliknte na soubor Upload_... .bat
   odpovdajc poadovan konfiguraci firmwaru.
4. Po vzv zadejte POUZE slo portu COM patcho Arduinu. Napklad pokud
   je zazen uvedeno jako "USB-SERIAL CH340 (COM46)", zadejte 46.
5. Vykejte na zvrenou zprvu o spchu nebo chyb. Bhem nahrvn
   nezavrejte okno a neodpojujte Arduino.

U variant 30720 skript nejprve zkou rychlost 115200 baud. Pokud AVRDUDE
ohls chybu komunikace nebo synchronizace, automaticky zopakuje pokus
rychlost 57600 baud.

Varianty 32256 vyaduj Optiboot a nahrvaj se rychlost 115200 baud.

DLEIT: Spoutjte soubor Upload_... .bat z hlavn sloky balku.
Soubor tools\UploadFirmware.bat je intern pomocn skript a nem se spoutt
pmo.

Pokud nahrvn sele, zkontrolujte sprvnost portu COM, ovte, zda ho
nepouv jin aplikace, a ujistte se, e USB kabel podporuje penos dat.
U varianty 32256 tak ovte, zda m deska nainstalovan Optiboot.

K EMU SLOU SOUBORY .with_bootloader.hex?
========================================

Soubory konc na .with_bootloader.hex obsahuj firmware spolen
s bootloaderem. Jsou ureny pro programovn pes ISP, nikoli pro bn
nahrvn pes USB. Ve standardnch USB skriptech je nepouvejte.

Pouijte je pouze tehdy, pokud chcete pomoc ISP programtoru naprogramovat
cel zazen. Postup ISP programovn a nastaven pojistek popisuje nvod
Arduino Nano Bootloader Fix:
https://github.com/e-Mole/MoleGraph/blob/master/docs/troubleshooting/02_arduino-nano-bootloader-fix.md

VLASTN KONFIGURACE FIRMWARU (PRO POKROIL)
========================================

Pro nejlep pizpsoben vlastnmu hardwaru doporuujeme zkompilovat
MoleGraphAuto a v souboru config.h zapnout pouze potebn idla. Firmware
tak mete pizpsobit konkrtn sestav a dit jeho nroky na pam Arduina
Nano.

Postup najdete v nvodu Memory Optimization & Sensor Configuration:
https://github.com/e-Mole/MoleGraph/blob/master/docs/troubleshooting/04_memory-optimization-config.md

SEZNAM PODPOROVANCH IDEL
========================================

Nsledujc seznam popisuje plnou konfiguraci MoleGraphAuto-v4.6-32256.hex.
Ostatn varianty maj vypnut idla nebo moduly uveden v nzvu souboru.

KINEMATIKA A MEN VZDLENOSTI
- I105 - TOF dlkomr (VL530X v pln variant; VL53L1X ve variantch
  vslovn oznaench v nzvu)
- D021 - pohybov idlo SRF04
- D035 - digitln posuvn mtko
- A039 - optick zvora/trbina 810H

MECHANIKA, MAGNETICK POLE A ZVUK
- D007 - silomr s HX711
- A006 - tlakov idlo MPX5700DP
- I003 - akcelerometr a magnetometr LSM303DLHC
- A023 - idlo magnetickho pole (Hallova sonda)
- A027 - idlo intenzity zvuku (mikrofon)

TERMODYNAMIKA A KLIMA
- W001 - teplomr DS18B20
- I005 - bezkontaktn teplomr MLX90614
- D034 - teplotn idlo MAX6675 s termolnkem typu K
- I002 - BME280: barometr, teplomr a vlhkomr

SVTLO A OPTIKA
- A018 - idlo intenzity osvtlen (fotorezistor)
- I032 - idlo intenzity osvtlen BH1750 (luxmetr)
- I031 - idlo UV zen VEML6070
- I011 - barevn idlo TCS34725 (reim BASIC a rozen reim MONITOR
  s podporou online aplikace MoleGraph ColorLab pro analzu barevnch dat,
  testovn kalibrace a zkoumn LUT)
- I011 - chemick kolorimetr vyuvajc TCS34725; m transmitanci
  v jednotlivch kanlech RGB i v celkovm kanlu C a poskytuje surov
  data RAW RGB+C

CHEMIE, KAPALINY A PLYNY
- A014 - pH idlo
- C015 - idlo TDS: vodivost a salinita
- A037 - ORP elektroda a modul
- A038 - zkalomr TS-300B
- C019 - idlo oxidu uhliitho MH-Z16
- A025 - idlo alkoholu MQ-3
- A036 - idlo MQ-2 pro LPG, propan, metan a vodk
- A020 - kyslkov plynov idlo SGX-VOX (O2)

LIDSK TLO A ZDRAV
- A022 - snma srdenho tepu
- A010 - EKG AD8232

ELEKTINA
- A028 - stejnosmrn napov idlo, 0-25 V
- A029 - stejnosmrn proudov idlo, 0-5 A s ACS712
- A030 - stejnosmrn proudov idlo, 0-30 A s ACS712

VSTUPN A DEMONSTRAN MODULY
- D200 - vstupn LED modul pro vizualizaci vzorkovac frekvence

VDY AKTIVN
- A101 - analogov vstup vyuvajc 10bitov ADC Arduina (SENSOR_AD)
- D103 - speciln asova (SENSOR_TIMER)
