This is an old revision of the document!


Function Generator

Introducere

Scopul acestui proiect este explorarea capacitatii placii de dezvoltare Arduino UNO de a functiona ca un generator de functii - un astfel de aparat este foarte util in dezvolatrea circuitelor electronice. Astfel produsul rezultat va trebuii sa fie capabil sa produca functii de semnal (de exemplu sinusoide) si PWM.

Fata de alte placi Arduino, UNO nu are un DAC.

Astfel este necesar sa se foloseasca alternative (de exemplu un DAC extern).

Proiectul este gandit astfel incat sa poate fi transformat intr-un shield Arduino care sa fie relativ accesibil din punct de vedere financiar (astfel sa se foloseasca cat mai putie componente externe si cat mai ieftine) si usor de realizat (chiar si acasa in principiu) avand capacitati si performante satisfacatoare pentru un hobbyist (nu pentru uz intens) si o interfata usor de folosit (dar in aceasi spirit de a folosi putine componente).

Descriere

Proiectul este un generator de functii capabil sa genereze sinusoide, semnale trapezoidale, triunghiulare si dinte de fierastrau (“sawtooth”) cu frecventa de 1Hz pana la 4.5kHz ajustabila cu pasi de 1Hz, amplitudie intre 1 si 5V cu pasi de 100mV, respectiv PWM cu unul sau doua canale cu frecventa comuna intre 1Hz si 100kHz ajustabila cu pasi tot de 1Hz si un factor de umplere setabil per canal de la 0% la 99% in pasi de 1%, cu o amplitudine data de tensiunea de alimentare. Astfel exista 3 iesiri, una de functie de semnal, si doua pentru cele doua canale de PWM. Aparatul poate functiona fie in modul waveform, fie in modul PWM (nu poate genera ambele in acelasi timp).

Iesirile, spre deosebire de un generator de functii normal sunt amplificate in putere. Etajul de filtrare pentru functii de semnal poate amlimenta fara perturbatii rezistente de 400Ω la amplitudinea maxima, iar partea de PWM este amplificata de un MOSFET driver deci poate fi direct conectata la sarcini inductive mari (util pentru testarea circuitelor ce contin tranzistori de putere).

Toate setarile sunt introduse printr-o interfata alcatuita dintr-un LCD 16×2 si 5 butoane push (ce au functiile de up, down, left, right si select/ok) folosite pentru a naviga pe ecran si a selecta / introduce valori.

Chiar daca intervalul de frecvente este ajustabil intr-un spectru continuu cu pasi de 1Hz nu toate frecventele sunt disponibile din cauza limitarilor software si hardware. Daca este introdusa o valoare care nu este disponibila, se va aplica si afisa cea mai apropiata valoare disponibia automat.

Hardware Design

Lista de componente folosite:

  • Arduino UNO R3
  • Resiztor 2.2kΩ x24 (THT, ±1%, 0.25W)
  • Resiztor 1kΩ x2 (THT, ±1%, 0.25W)
  • Resiztor 400Ω (THT, ±1%, 0.25W) (doar pentru testare)
  • Condensator electrolitic 1μF (50V, THT)
  • Condenator ceramic 571pF x2 (THT)
  • Push button x5 (THT)
  • MCP602 OpAmp (THT, DIP) Datasheet
  • TC427CPA MOSFET driver IC (THT, DIP) Datasheet
  • LCD 16×2 + modul I2C Pagina magazin
  • Breadboard
  • Jumper cables
  • 22AWG Solid cable (folosit pentru conexiuni breadboard - breadboard)

Solutia gasita pentru a suplini lipsa unui DAC intern a fost utilizarea unei solutii software pe Arduino + realizarea unui DAC R2R. Alternativa aceasta a fost aleasa in primul rand pentru ca aceasta este tema proiectului - explorarea capacitatiilor placii Arduino dar si pentru costul foarte redus. DAC-ul are o rezolutie de 8 biti si este conectat la pinii 0-7 aferenti portului PD al μC-ului Atmega328P (si atfel se realizeaza transformarea in tensiune a valorii scrise pe port in registrul aferet din software). Pentru partea de PWM lucrurile sunt mai simple deoarece exista suport hardware din partea μC-ului.

In final, pentru partea de funtie de semnal s-a folosit un filtru activ Sallen-Key cu factor de amplificare unitar pentru imbunatatirea calitatii formei de unda rezultate la iesirea DAC-ului, iar pentru PWM IC-ul specificat. Alegerea unui LCD I2C este data de utilizarea extensiva a pinilor placii Arduino UNO in cadrul acestui proiect.

Alimentarea intregului aparat se face prin conectorul de alimentare coaxial al placii Arduino. Tensiunea nu trebuie sa aiba o valoare precisa, dar schimbarea ei va afecta amplitudinea PWM (care este data de tensiunea de alimentare).

Software Design

Realizarea partii de software urmareste cele doua parti principale (vizibile atat in schema bloc cat si in schema electrica): partea de generare de semnale si partea de interfata cu utilizatorul.

Signal

Generarea semnalelor (implementarea functionalitatii de generator de functie) se face in biblioteca Signal (Signal.hpp) printr-o clasa care ofera toate functiile necesare. In plus este stabilit un API foarte simplu prin care se pot oricand adauga forme de unda noi.

Clasa Signal expune urmatoarea structura:

  • void waveformSetup() Initializeaza registrii si date interne pentru a putea genera functii de semnal. Aceasta functie trebuie mereu apelata inainte de orice alta operatie legata de partea de waveform. Orice alte configuratii prealabile de orice fel sunt sterse.
  • byte waveformLoad(const byte* wave, byte amplitude = WAVEFORM_MAX_AMPL) Incarca in memoria interna datele functiei de semnal data cu aplitudinea specificata ca valori intregi intre 10 si 50 reprezentand sute de mV. Pentru schimbarea amplitudinii trebuie facuta o reincarcare totala a datelor functiei de semnal. In plus pentru ca programul sa functioneze corect trebuie ca datele sa fie declarate cu API - ul oferit ce va fi detaliat ulterior. Valoarea de retur este amplitudinea aplicata pe semnal (care poate diferi de valoarea ceruta daca aceasta este invalida).
  • int waveformSetFrequency(int frequency) Seteaza frecventa functiei de semnal la cea mai apropiata valoare posibila de cea data (valoarea aplicata fiind returnata) in intervalul 1 - 4500Hz.
  • void waveformEnable() / void waveformDisable() / void waveformToggleState() Functii care activeaza sau dezactiveaza temporar generarea de semnal pastrand toate configuratiile intacte.
  • void pwmSetup(bool dualChannel = false) Initializeaza registrii si date interne pentru a putea genera PWM. Aceasta functie trebuie mereu apelata inainte de orice alta operatie legata de partea de PWM. Orice alte configuratii prealabile sde orice fel unt sterse. Se sepcifica daca se doreste generarea pe unul sau ambele canale de PWM, iar schimbarea acestei setari necesita un nou apel la aceasta functie.
  • long pwmWrite(long frequency, byte dutyCycleChannelA = 50, byte dutyCycleChannelB = 0) generaza semnalul(le) de PWM cu frecventa (intre 1Hz si 100kHz) si factorul de umplere dat per canal (intre 0 si 99 in procente). Frecventa aplicata este returnata si reprezinta cea mai apropiata valoare posibila de cea data.

Generarea funtiei de semnal se face prin iterarea in tabloul de valori al functiei de semnal prin pargurgerea ciruluara element cu element - trecerea de la o iteratie la alta se face printr-o intrerupere la interbale precise cu ajutorul Timer/Counter1 - si scrierea valorii pe portul D. Generarea PWM se face cu acelasi timer configurat in modul Fast PWM.

Datele unei functii de semal sunt reprezentate de un tablou unidimenional de 64 de octeti avand valori de la 0 la 255 corespunzator amplitudinii instantanee din acel moment intre 0 si 5V. Tabloul este stocat in memoria de program pentru a nu lua din memoria SRAM limitata. Pentru a declara o functie de semnal (waveform) se foloseste API - ul folosit, de exemplu pentru declararea unei functii “CastleWave”:

WAVEFORM_DECL(Castle) = { /* 64 Valori ... */ };

LCDInterface

Cea de-a doua biblioteca cu care vine partea de software este cea care se ocupa de interfata cu utilizatorul. Bilioteca LCDInterface are rolul de a creea o interfata virtuala (logica) peste un API de comunicare cu un LCD I2C si 5 butoane de selectie / navigare (up, down, left, right, ok/select). Biblioteca introduce 3 clase / structuri / enitati care reaizeaza interfata logica:

  • Page un alias catre un tablou bidimenional de dimeniuni fixe continand caracterele / simbolurile care alcatuiesc o pagina - o suprafata logica de dimensiunea display-ului in care sunt afisate informatii. Continutul paginii va fi continutul fix afisat pe display casuta cu casuta.
  • Cell o celula este o unitate de informatie / continut modificabila de catre utilizator. Aceasta are un tip, o pozitie, o valoare minima si maxima si este asociata unei pagini printr-un index de pagina. Implementarea este sub forma de clasa care contine un numar de metode publice insa acestea nu sunt facute pentru a fi folosite din exterior. Importante sunt cele trei tipuri / moduri de functionare ale unei celule:
    • OnOffSwitch o celula care prin apasarea select trece de la valoarea minima sau maxima si viceversa
    • MultiSwitch o celula care trece prin apasarea select ciclic valoare cu valoare de la valoarea minima la cea maxima
    • DataBox o celula care prin apasarea select intra in modul de introducere de valoare al care interval este dat de cele doua valori ale celulei, iar prin apasarea up / down se face trecerea pas cu pas intre ele; pentru salvarea valorii se apasa din nou ok
  • LCDInterface clasa principala care alcatuieste interfata virtuala si este facuta pentru a fi folosita extern. Clasa este un accepta valorile fixe ale paginilor corespunzatoare dimeniunii LCD - ului, adresa sa I2C, tablourile de pagini si celule definiti in prealabil impreuna cu dimeniunea lor. Exista o serie de limitari de dimensiuni: pot fi maxim 32 de pagini si 127 de celule. Prin aceasta clasa se vine cu logica de navigare intre pagini si in pagini cu ajutorul unui cursor ce apare in josul casutei curente si cu logica de interactiune cu celulele. Merodele oferite de aceasta clasa sunt:
    • void initialize() Initializeaza instanta curenta. Aceaasta metoda trebuie chemata intotdeauna apelata inainte de folosirea instantei pentru prima oara.
    • void nextPage() Incarca urmatoarea pagina pe ecranul LCD.
    • void pressLeft() Apasa butonul virtual / logic de left.
    • void pressRight() Apasa butonul virtual / logic de right.
    • void pressUp() Apasa butonul virtual / logic de up.
    • void pressDown() Apasa butonul virtual / logic de down.
    • void pressSelect(Handler<const Cell&> handler = nullptr) Apasa butonul virtual / logic de select. Primeste un handler (functie care nu returneza nimic) ce contine logica furnizata de utilizatorul clasei ce trebuie sa se execute la apasare dupa ce se executa logica interna legata de celula curenta. Un exemplu de logica aditionala este aprinderea unui led, trimiterea de date sab suprascrierea de casute fixe pe ecran.
    • void registerCustomChar(char value, const byte* points) Realizeaza redirectarea catre functia corespunzatoare din biblioteca utilizata in spate pentru LCD-ul I2C. Se da un tablou de 8 octeti in care doar primii cinci biti sunt folositi pentru a crea o matrice ce descrie simbolul definit. Simbolul va surascrie valoarea ASCII a caracterului furnizat.
    • String read(Position position, byte length) Citeste incepand cu pozitia data valorile din numarul de casutele / celulele furnizat intr-un String. Daca lungimea ceruta depaseste randul curent se va returna un string mai scurt.
    • String readReverse(Position position, byte length) La fel ca 'read', doar ca ordinea de citire e inversata. Util pentru citirea de numere.
    • void write(Position position, String str, bool cellOverride = false) Scrie string-ul furnizat pe interfata virtuala si pe ecranul fizic incepand pe pozitia data pana la termiarea striungului sau a randului. Prin ultimul paramentru se controleaza corelarea datelor intre cele oferite si cele prezente in celule. Pentru valoarea 'false' se pun datele din celule pe ecran si de ignora cele date, altfel se sprascriu datele din celule cu cele date.

Prin “apasarea” butoanelor virtuale se muta cursorul care indica casuta curenta de pe ecran. Acest lucru nu este insa valabil cand este selecata o celula de tip 'DataBox' pentru introducre de date. Atunci apelurile catre functiile de butoane nu mai muta cursorul in schimb functioneaza doar cele de 'up' si 'down' care realizeaza ciclarea prin valorile pe celula.

Toate pozitiile din biblioteca sunt specificate prin structura:

struct Position { byte row, column };

In afara de functii built-in din mediul Arduino am folosit biblioteca LiquidCrystal_I2C: Link Github

FunctionGenerator

Acesta este fisierul .ino in care este cod specific proiectului, construit pe baza celor doua biblioteci anterior descrise. Aici este pastrata starea aparatului, este gestionata apasarea butoanelor (prin functia loop specifica Arduino si intreruperi de tip pin change - PCINT; mai precis, in ISR - uri se detecteaza si se salveaza ce buton a fost apasat iar apoi in loop se face pooling pentru a apela metoda corespunzatoare de press din LCDInterface; in final toata logica suplimentara la selectia diferitelor elemente de pe ecran este tratata prin handlerul dat ca paramentru metodei LCDInterface::pressSelect) si sunt realizate initializarile necesare (functia setup specifica Arduino).

Utilizare

Utlizatorul aparatului trebuie doar sa seteze modul dorit si parametrii specifici fiecarui mod de functionare (waveform, PWM). Acest lucru se face prin navigarea si selectia pe ecran cu ajutorul celor 5 butoane. Intotdeauna exista o casuta curenta pe ecran (similar cu un element de interfata cu utilizatorul dintr-un GUI - de exemplu un buton - atunci cand se face navigarea cu tab) care este evidentiata printr-un cursor de tip underscore (“_”) ce este miscat prin cele 4 taste de directie.

Dupa pornirea aparatului cursorul nu este afisat.

Este necesar sa se apase o tasta de directie pentru a fi mutat cursorul pentru prima data si a fi afisat. Acesta este situat le pornire mereu in casuta din coltul stanga-sus al ecranului.

Introducerea parametrilor / setarilor se face in casutele corespunzatoare astfel:

  • Pentru cele de tip switch (OnOffSwitch sau MultiSwitch) se apasa tasta select pentru trececerea ciclica intre valori atunci cand cursoarul este pe casuta aferenta acelei setari. Schimbarea efectiva a parametrului setat se face imediat fara alte comenzi suplimentare. Daca setarea are valori ale caror nume necesita mai multe casute pentru afisare, casuta care este activa - care are comportamentul descris anterior - este mereu (si doar) prima
  • Pentru cele in care se pot introduce date - in cazul aparatului valori numerice (de tip DataBox) trebuie mai intai selectate prin apasarea select; atunci se blocheaza cursorul pentru a mai fi mutat si acesta este inlocuit cu unul de tip blinking box si se poate cicla prin valorie disponibile prin abasarea butoanlor up si down; pentru salvarea valorii introduse si intoarcerea la cursorul normal care permite navigarea pe ecran trebuie apasat din nou select.

Casutele alaturate care permit introducerea de cifre fromeaza impreuna un numar. Chiar daca se poate schimba doar valoarea unei cifre la un moment dat, valoarea citita de aparat este formata din toate cifrele.

Daca este introdusa o valoare invalida sau indisponibila, se considera si afisa cea mai apropiata valoare valida.

Descrierea completa a interfetei se regaseste in imaginile de mai jos:

In imagine e prezentata structura ecranului cand modul este Waveform, outputul este dezactivat (O arata ca prin apasare se activeaza semnalul, X arata dezactivarea), iar tipul de semnal este Sawtooth (SAW - Sawtooth wave, SIN - Sine wave, TRI - triangle wave, TPZ - trapezoidal wave).

In imagine e prezentata structura ecranului cand modul este PWM, outputul este activat (O arata ca prin apasare se activeaza semnalul, X arata dezactivarea), si este activ un singur canal (SCH - Single channel mode, DCH - dual channel mode).

Testare & Demo

Pentru testarea proiectului am realizat un prototip pe breadboard utilizand exact componentele specificate in sectiunea de design hardware. Pe langa asta am utilzat urmatoarele instrumente pentru testare:

  • Sursa de alimentare reglabila
  • Multimetru
  • Osciloscop digital

Prototipul rezultat este ilustrat in imaginile de mai jos:

Exemple de modaliati de functionare ale dispozitivului:

  • Triangular Wave, 3.5V, 100Hz

  • Sine Wave, 5V, 3kHz

  • PWM single channel, 1kHz, 35% duty cycle

  • PWM dual channel, 64kHz, 70% duty cycle A, 52% duty cycle B

Live demo pentru modul Waveform: Video

Live demo pentru modul Waveform: Video

Concluzii & Future Work

Proiectul poate primi o serie de imbunatatiri fata de forma descrisa / deja implementata pentru a extinde capacitatiile acestuia:

  1. Frecventa maxima obtinuta in modul waveform este limitata in primul rand de software. Overheadul unei intreruperi este mare pentru astfel de aplicatii, mai ales in contextul in care codul dat de compilator nu este prea eficient pentru ISA-uri. In particular este pesimist in ceea ce priveste utilizarea registrilor si simte nevoia sa faca prea multe salvari pe stiva. Schimbarea codului din ISA-ul pentru waveform cu unul in limbaj de asamblare (inline assembly + ISR_NAKED) poate creste frecventa pana la 5kHz (acest lucru inca nu a fost realizat deoarce programul functiona incorect cu toate variantele de cod incercat). Mai departe rezervarea unor registrii globali poate aduce o dublare pana la 10kHz, dar acest lucru presupune abandonarea mediului Arduino si programarea in C fara a folosi nicio bibioteca externa (totul de la zero), inclusiv multe functii din implementarea libc pentru AVR (dintre cele precompilate).
  2. Filtrul Salem-Key nu are un efect de filtrare sufiient de bun pentru netezirea frecventelor mici. Ar fi nevoie de un filtru realizat cu trimmer programabil. Exista astfel dd IC-uri, insa tind sa aiba o plaja mica de capacitante. In cazul aparatului ar fi nevoie de ceva in intervalul de cativa μF - sute de pF. Acest lucru poate fi realizat cu un decodor pe 3 biti (ultimii 3 pini liberi ai placii), de exemplu 74HC237 care sa comande MOSFET-uri de joasa putere precum 2N7000 care la randul lor sa cupleze condensatorii necesari. Asta poate permite o reducere a numarului de valori necesare pentru reconstruirea semnalului, deci la crestera frecventei maxime (o limita realista este in jurul a 20kHz).

Cu toate acestea raman suficiente limitari pe partea de generare de waveform care pot fi prea mari pentru un alt uz decat cel ocazional in regim de hobby-ist. Pentru o performanta mult mai buna trebuie inlocuita intreaga parte de generare de functii de unda (hardware + parte din software) cu un DAC cu memorie interna (cu o interfata I2C sau SPI), sau chiar cu un IC dedicat pentru generare de semnale.

Dintre acestea, cel mai probabil varianta cu DAC-ul este mai avantajoasa din punct de vedere al costului si inca ofera flexibilitatea de a genera semnale oarecare definite in soft. Totusi aceste alternative ies intr-o anumita masura din scopul initial al proiectului - acela de a testa capacitatiile intrinseci ale placii Arduino UNO de a functiona ca generator de functii de semnal.

Download & Resurse aditionale

pm/prj2021/avaduva/functiongenerator.1622324614.txt.gz · Last modified: 2021/05/30 00:43 by andrei.biu
CC Attribution-Share Alike 3.0 Unported
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0