From fe908f3317be96fd5a767d36175e1569ca55dea9 Mon Sep 17 00:00:00 2001 From: David Lenfesty Date: Tue, 22 Oct 2019 12:26:26 -0600 Subject: [PATCH] Initial code for lab 3 --- lab_2/report.fdb_latexmk | 26 +- lab_2/report.log | 32 +- lab_2/report.pdf | Bin 70304 -> 69895 bytes lab_2/report.synctex.gz | Bin 21018 -> 18183 bytes lab_2/report.tex | 5 - lab_3/i2cmaster/i2cmaster.zip | Bin 0 -> 28523 bytes lab_3/lcdlibrary/Makefile | 334 +++++++ lab_3/lcdlibrary/doxygen.css | 1449 ++++++++++++++++++++++++++++++ lab_3/lcdlibrary/doxygen.png | Bin 0 -> 3779 bytes lab_3/lcdlibrary/lcd.c | 592 ++++++++++++ lab_3/lcdlibrary/lcd.h | 369 ++++++++ lab_3/lcdlibrary/lcdlibrary.zip | Bin 0 -> 32563 bytes lab_3/lcdlibrary/manual_lcd.html | 934 +++++++++++++++++++ lab_3/lcdlibrary/test_lcd.c | 167 ++++ lab_3/main.c | 65 +- lab_3/main.h | 5 + 16 files changed, 3941 insertions(+), 37 deletions(-) create mode 100644 lab_3/i2cmaster/i2cmaster.zip create mode 100644 lab_3/lcdlibrary/Makefile create mode 100644 lab_3/lcdlibrary/doxygen.css create mode 100644 lab_3/lcdlibrary/doxygen.png create mode 100644 lab_3/lcdlibrary/lcd.c create mode 100644 lab_3/lcdlibrary/lcd.h create mode 100644 lab_3/lcdlibrary/lcdlibrary.zip create mode 100644 lab_3/lcdlibrary/manual_lcd.html create mode 100644 lab_3/lcdlibrary/test_lcd.c create mode 100644 lab_3/main.h diff --git a/lab_2/report.fdb_latexmk b/lab_2/report.fdb_latexmk index 2478d44..e016be1 100644 --- a/lab_2/report.fdb_latexmk +++ b/lab_2/report.fdb_latexmk @@ -1,8 +1,8 @@ # Fdb version 3 -["pdflatex"] 1571094986 "/home/david/Documents/homework/ECE_312/lab/lab_2/report.tex" "/home/david/Documents/homework/ECE_312/lab/lab_2/report.pdf" "report" 1571094987 +["pdflatex"] 1571763854 "/home/david/Documents/homework/ECE_312/lab/lab_2/report.tex" "/home/david/Documents/homework/ECE_312/lab/lab_2/report.pdf" "report" 1571763856 "/etc/texmf/web2c/texmf.cnf" 1567530603 475 c0e671620eb5563b2130f56340a5fde8 "" - "/home/david/Documents/homework/ECE_312/lab/lab_2/report.aux" 1571094986 1101 1a30b85b54e6101e6788286e2d2e7d17 "" - "/home/david/Documents/homework/ECE_312/lab/lab_2/report.tex" 1571094984 3014 3a4851ebeb75343421edf4abaf2e0061 "" + "/home/david/Documents/homework/ECE_312/lab/lab_2/report.aux" 1571763856 1101 1a30b85b54e6101e6788286e2d2e7d17 "" + "/home/david/Documents/homework/ECE_312/lab/lab_2/report.tex" 1571763852 2878 8a0466ce1c1444c68616666c8ed66266 "" "/usr/share/texlive/texmf-dist/fonts/map/fontname/texfonts.map" 1511824771 3332 103109f5612ad95229751940c61aada0 "" "/usr/share/texlive/texmf-dist/fonts/tfm/public/amsfonts/cmextra/cmex7.tfm" 1480098698 1004 54797486969f23fa377b128694d548df "" "/usr/share/texlive/texmf-dist/fonts/tfm/public/amsfonts/cmextra/cmex8.tfm" 1480098698 988 bdf658c3bfc2d96d3c8b02cfc1c94c20 "" @@ -84,17 +84,17 @@ "/usr/share/texlive/texmf-dist/tex/latex/xcolor/xcolor.sty" 1480098843 55589 34128738f682d033422ca125f82e5d62 "" "/usr/share/texlive/texmf-dist/web2c/texmf.cnf" 1520210507 32485 c64754543d8ac501bea6e75e209ea521 "" "/usr/share/texmf/web2c/texmf.cnf" 1520210507 32485 c64754543d8ac501bea6e75e209ea521 "" - "/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map" 1568140038 2361257 726fe6b8da9ff7c93aa3fe9e1a980b90 "" - "/var/lib/texmf/web2c/pdftex/pdflatex.fmt" 1567717912 724917 8f47dfd9e170416fd47eaec382daba57 "" - "report.aux" 1571094986 1101 1a30b85b54e6101e6788286e2d2e7d17 "" - "report.out" 1571094986 259 c3c35b14c3a91f538e188aae8cf11d7b "" - "report.tex" 1571094984 3014 3a4851ebeb75343421edf4abaf2e0061 "" - "report.toc" 1571094986 349 2e22671396011105a0637f600dfbb12c "" + "/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map" 1571178984 2398241 5e1d59013fffd6a00fd713275690e0d4 "" + "/var/lib/texmf/web2c/pdftex/pdflatex.fmt" 1571178993 813573 e4567727fdf7e1b21053a4ebc3086b19 "" + "report.aux" 1571763856 1101 1a30b85b54e6101e6788286e2d2e7d17 "" + "report.out" 1571763856 259 c3c35b14c3a91f538e188aae8cf11d7b "" + "report.tex" 1571763852 2878 8a0466ce1c1444c68616666c8ed66266 "" + "report.toc" 1571763856 349 2e22671396011105a0637f600dfbb12c "" (generated) - "report.pdf" - "/home/david/Documents/homework/ECE_312/lab/lab_2/report.log" - "report.log" "report.aux" - "report.toc" + "report.pdf" "report.out" + "report.log" + "report.toc" + "/home/david/Documents/homework/ECE_312/lab/lab_2/report.log" "/home/david/Documents/homework/ECE_312/lab/lab_2/report.pdf" diff --git a/lab_2/report.log b/lab_2/report.log index 6df8991..9d90964 100644 --- a/lab_2/report.log +++ b/lab_2/report.log @@ -1,4 +1,4 @@ -This is pdfTeX, Version 3.14159265-2.6-1.40.18 (TeX Live 2017/Debian) (preloaded format=pdflatex 2019.9.5) 14 OCT 2019 17:16 +This is pdfTeX, Version 3.14159265-2.6-1.40.18 (TeX Live 2017/Debian) (preloaded format=pdflatex 2019.10.15) 22 OCT 2019 11:04 entering extended mode restricted \write18 enabled. file:line:error style messages enabled. @@ -6,7 +6,7 @@ entering extended mode **/home/david/Documents/homework/ECE_312/lab/lab_2/report.tex (/home/david/Documents/homework/ECE_312/lab/lab_2/report.tex LaTeX2e <2017-04-15> -Babel <3.18> and hyphenation patterns for 3 language(s) loaded. +Babel <3.18> and hyphenation patterns for 7 language(s) loaded. (/usr/share/texlive/texmf-dist/tex/latex/base/article.cls Document Class: article 2014/09/29 v1.4h Standard LaTeX document class (/usr/share/texlive/texmf-dist/tex/latex/base/size12.clo @@ -417,29 +417,29 @@ File: umsb.fd 2013/01/14 v3.01 AMS symbols B \openout5 = `report.toc'. [2] [1] [2] -Package atveryend Info: Empty hook `BeforeClearDocument' on input line 132. +Package atveryend Info: Empty hook `BeforeClearDocument' on input line 127. [3] -Package atveryend Info: Empty hook `AfterLastShipout' on input line 132. +Package atveryend Info: Empty hook `AfterLastShipout' on input line 127. (/home/david/Documents/homework/ECE_312/lab/lab_2/report.aux) -Package atveryend Info: Executing hook `AtVeryEndDocument' on input line 132. -Package atveryend Info: Executing hook `AtEndAfterFileList' on input line 132. +Package atveryend Info: Executing hook `AtVeryEndDocument' on input line 127. +Package atveryend Info: Executing hook `AtEndAfterFileList' on input line 127. Package rerunfilecheck Info: File `report.out' has not changed. (rerunfilecheck) Checksum: C3C35B14C3A91F538E188AAE8CF11D7B;259. -Package atveryend Info: Empty hook `AtVeryVeryEnd' on input line 132. +Package atveryend Info: Empty hook `AtVeryVeryEnd' on input line 127. ) Here is how much of TeX's memory you used: - 8854 strings out of 494923 - 128188 string characters out of 6180743 - 231498 words of memory out of 5000000 - 11996 multiletter control sequences out of 15000+600000 + 8849 strings out of 494847 + 128113 string characters out of 6179079 + 231743 words of memory out of 5000000 + 12005 multiletter control sequences out of 15000+600000 12564 words of font info for 49 fonts, out of 8000000 for 9000 - 14 hyphenation exceptions out of 8191 + 59 hyphenation exceptions out of 8191 37i,9n,39p,318b,1628s stack positions out of 5000i,500n,10000p,200000b,80000s -Output written on /home/david/Documents/homework/ECE_312/lab/lab_2/report.pdf (5 pages, 70304 bytes). +Output written on /home/david/Documents/homework/ECE_312/lab/lab_2/report.pdf (5 pages, 69895 bytes). PDF statistics: - 140 PDF objects out of 1000 (max. 8388607) - 125 compressed objects within 2 object streams - 59 named destinations out of 1000 (max. 500000) + 134 PDF objects out of 1000 (max. 8388607) + 119 compressed objects within 2 object streams + 54 named destinations out of 1000 (max. 500000) 41 words of extra memory for PDF output out of 10000 (max. 10000000) diff --git a/lab_2/report.pdf b/lab_2/report.pdf index 030c08b2d56ce39554467f94c0d2430f4101c0ee..8229bc86b1580054581d0d651dc25a88c7b07521 100644 GIT binary patch delta 6611 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 literal 21018 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 diff --git a/lab_2/report.tex b/lab_2/report.tex index e5610bc..905b3e3 100644 --- a/lab_2/report.tex +++ b/lab_2/report.tex @@ -87,11 +87,6 @@ main(): reset flag playing play_rest() -// Will play rest of current beat then shut off -button_press_interrupt(): - disable_interrupts() - set flag interrupt_button_press - // Plays one full beat play_beat(): if current_note_has_duration: diff --git a/lab_3/i2cmaster/i2cmaster.zip b/lab_3/i2cmaster/i2cmaster.zip new file mode 100644 index 0000000000000000000000000000000000000000..b51c7ddc84cf9a3183d427a9c452f92a5a5e9178 GIT binary patch literal 28523 zcmZ6TbBrf2*YAI0?bx<$+qP}nw#}WH9ox2Tdv|b^ zhW5jqG43vaY);ioWV`OVV0CV1id(LwOFbdkn5_#h8iZtxM+MI!Z=X1a1_NqRqm39zauJW(>Z{E{T+y!R$%^n=N-;Ikdj}E`Gd{T`S+g?vma)NEtD() zPsdaL!~Hg{KBXK}fdnd1FTW%+{Zk^O=`pzWjG)5YaX@Hp3OC#X@o;K(36Bm~T^2Hk zHx3y010PjxQ=$X+AQ0pfVdJ1<(&KOPxDb=5XwxYqx@K*Qso3=gsm|F*Cld7>f49a( zfBKL`#EaRSg;p4|gZ#+c1W&>~3kv$^k@!xa!>g%Mw$jMB!mPu#PpcqWhuz zJhnyPj5=Wya}yZyFg~3Gr;8=^IW@`8+eAKv1|*?L zkO+rFQn-Lg0Jvr~wXNQJisiD5ojCXX@Q_(eE`jVYR6Al9f5ZXyF`>rS7?jgX9{n#H zbLE_k`UIq_sD%eLP3z{uqWb3S^C?sufQ6#H!AYN-WV}d;Q1Ag;+^D1$9u{!lia-Ob zke6{O5<3gT3%rp**vOuZ{~;qVR4GI+9s1UM(<(kK4TYd2TqtJ`#0u~!aRCOr5d;tj z*Z|qW+d{>_d}*S1AiTLJ_YIwYhk-jbev6Oy6Fr!VCu{OI4f=3Zi1_6?AXS6Xqo5*p~EAGZagD>QD~`bISA zAKSF`dr;`H`w){yjVeM0OjXHdqL@J?AIj97bfG`EZesUI6jayaVCqYX!!PNK8N;H@ zVaPQ&Y?t53NwYR`lytPx@_xD+DVvjxL&I^yefg4wE6w^j$0Dj(T2^#+YRrK_~Aa z(+v<#k7R4Ze<3M`76s5RACAc3-BT<=b_cVkTJ(_+&RcdhYNMw9vJ@Z?f3!;^FfHG> zafEKfYUzY3P{E<6(#`k=DFROj3JO2C#*TjHDx|mC999(mw9|{7+^Q`vf{bQ8gIO;s zx5pwzzPLSQ(eKySYl)ekTu~H;pE3Iq$ZSWyp!m7&{A*=c`gi}b3~00h|HUaK$#qC~ zaD6TEJBI7}jmKdR8c%5ymV%TslX*~@5!wVi{+^+Fj|h49C*UD_N&r52c-?ODB~VK$ zcW(9tcd?xzm}Mh*yypnKVwBByOt

qpep>?I%}8?_e$or(xi^co@utmMChrl&H{J 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 z zu5y5kOepnzZ~K*^aerYDOpQOIN24MkZ+_zg+Pu90-I%z{SSO`m-6Cj7uGobu<80_w*Z=gRV86pWKYk7%F^i#^@l z*q!4T1DN%O)_4=^+;;tztj3Jeg9m(bWTZav<->z0P>)vPG1EBf$@i$wN0bl`4s*ev zafgt=QyoQpxNI+!kDM}aU4>W0_hq@TX`azidHIS3zO>uSxS9K%)v~>UVltOQWT;9w zK=_7)w*)|wN&h9XU4xkC{=uH9=M8f`*aeZWeGkWGaECQ(E8^SKU*e*O#ps1`1Nx`lcupc3y zPguO;ePqvXDLZ71kvO}thpYR2@dvdu^|L8iB;W!}3Ac0fxyz#`R1qZGGwg?nH5Qb- z0(CJ3~eDKS!VJO7yVB5AP5|@ z?o|HQD%f}&59$rNm2p1<`HBX#h@rZr8dFQ2`^q$atl2?VBdf+6k0+Sjl2nzS-)3Ky z3Z0OAoC}#pynp@@pGVeQkrSE!<&=LTR;JGQcDVY|;Klo<^aJ3u-nIG*j7f6(j^Vav zUdCW9l0?;a@VKS*p0m!n!==MxU`iswN3l-O8cB`~^7L|kZD*AOl!hv5oa*U)vNTEI zpi(XeN6hH#ykqc22LDW{X71`RtKbyk10Mm9@li8A>S_qDt`hGz7tiYQkia1#FdGe` zoTgvyeSfHbphw=zLQp<cm)Gq2vgdLFM z1Bz*j`k+{D8a8vM0JqQhQS$|&C<6qH3i$8;P5Y~&3J5^>*YIci-+xj2C;y)s-2X-W zi% +#vpath %.S + + +# Optimization level, can be [0, 1, 2, 3, s]. +# 0 = turn off optimization. s = optimize for size. +# (Note: 3 is not always the best optimization level. See avr-libc FAQ.) +OPT = s + + +# Place -D or -U options here +# Uncomment below line if you want to use a separate file lcd_definitions.h +# for display and target specific definitions +#CDEFS = -D_LCD_DEFINITIONS_FILE + + +# Place -I options here +CINCS = + + +#---------------- Compiler Options ---------------- +# -gdwarf-2: generate debugging information +# -O*: optimization level +# -f...: tuning, see GCC manual and avr-libc documentation +# -Wall...: warning level +# -Wa,...: tell GCC to pass this to the assembler. +# -adhlns...: create assembler listing +CFLAGS = -DF_CPU=$(F_CPU)UL +CFLAGS += $(CDEFS) $(CINCS) +CFLAGS += -I. $(patsubst %,-I%,$(EXTRAINCDIRS)) +CFLAGS += -std=gnu99 +CFLAGS += -gdwarf-2 +CFLAGS += -O$(OPT) +CFLAGS += -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums +CFLAGS += -Wall -Wstrict-prototypes +CFLAGS += -Wa,-adhlns=$(<:.c=.lst) +CFLAGS += -save-temps + + +#---------------- Assembler Options ---------------- +# -Wa,...: tell GCC to pass this to the assembler. +# -adhlns=$(<:.S=.lst) create listing +# -gdwarf-2: generate debugging information +ASFLAGS = -DF_CPU=$(F_CPU)UL -x assembler-with-cpp -Wa,-gdwarf2 + +#---------------- Library Options ---------------- +# Minimalistic printf version +PRINTF_LIB_MIN = -Wl,-u,vfprintf -lprintf_min + +# Floating point printf version (requires MATH_LIB = -lm below) +PRINTF_LIB_FLOAT = -Wl,-u,vfprintf -lprintf_flt + +# If this is left blank, then it will use the Standard printf version. +PRINTF_LIB = +#PRINTF_LIB = $(PRINTF_LIB_MIN) +#PRINTF_LIB = $(PRINTF_LIB_FLOAT) + + +# Minimalistic scanf version +SCANF_LIB_MIN = -Wl,-u,vfscanf -lscanf_min + +# Floating point + %[ scanf version (requires MATH_LIB = -lm below) +SCANF_LIB_FLOAT = -Wl,-u,vfscanf -lscanf_flt + +# If this is left blank, then it will use the Standard scanf version. +SCANF_LIB = +#SCANF_LIB = $(SCANF_LIB_MIN) +#SCANF_LIB = $(SCANF_LIB_FLOAT) + + +MATH_LIB = -lm + + + +#---------------- External Memory Options ---------------- + +# 64 KB of external RAM, starting after internal RAM (ATmega128!), +# used for variables (.data/.bss) and heap (malloc()). +#EXTMEMOPTS = -Wl,-Tdata=0x801100,--defsym=__heap_end=0x80ffff + +# 64 KB of external RAM, starting after internal RAM (ATmega128!), +# only used for heap (malloc()). +#EXTMEMOPTS = -Wl,--defsym=__heap_start=0x801100,--defsym=__heap_end=0x80ffff + +EXTMEMOPTS = + + + +#---------------- Linker Options ---------------- +# -Wl,...: tell GCC to pass this to linker. +# -Map: create map file +# --cref: add cross reference to map file +LDFLAGS = -Wl,-Map=$(TARGET).map,--cref +LDFLAGS += $(EXTMEMOPTS) +LDFLAGS += $(PRINTF_LIB) $(SCANF_LIB) $(MATH_LIB) + + + +#---------------- Programming Options (avrdude) ---------------- + +# Programming hardware: Type: avrdude -c ? to get a full listing. +AVRDUDE_PROGRAMMER = usbasp + +# usb, com1 = serial port, lpt1 = parallel port +AVRDUDE_PORT = USB + +AVRDUDE_WRITE_FLASH = -U flash:w:$(TARGET).hex +#AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep + +# Uncomment the following if you do /not/ wish a verification to be performed after programming the device. +#AVRDUDE_NO_VERIFY = -V + +# Disable save mode for fuses +AVRDUDE_NO_SAFEMODE = -u + +# Uncomment the following if you want avrdude's erase cycle counter. +# Note that this counter needs to be initialized first using -Yn, +#AVRDUDE_ERASE_COUNTER = -y + +# Increase verbosity level. +#AVRDUDE_VERBOSE = -v -v + +# Adjust programming speed of USBasp +# no -B switch 375khz (default) +# -B 2000 500 hz +# -B 1000 1khz +# -B 500 2khz +# -B 250 4khz +# -B 125 8 khz +# -B 62 16khz +# -B 31 32khz * the cutoff for bit banged isp +# -B 10 93.75 khz +# -B 5 187.5 khz +# -B 2 375 khz +# -B 1 750 khz +# -B .5 1.5mhz +AVRDUDE_SPEED = -B .5 + +AVRDUDE_FLAGS = -p $(MCU) -P $(AVRDUDE_PORT) -c $(AVRDUDE_PROGRAMMER) +AVRDUDE_FLAGS += $(AVRDUDE_NO_VERIFY) +AVRDUDE_FLAGS += $(AVRDUDE_NO_SAFEMODE) +AVRDUDE_FLAGS += $(AVRDUDE_ERASE_COUNTER) +AVRDUDE_FLAGS += $(AVRDUDE_SPEED) +AVRDUDE_FLAGS += $(AVRDUDE_VERBOSE) + + + +#============================================================================ +# Output format. (can be srec, ihex, binary) +FORMAT = ihex + +# Define programs and commands. +#SHELL = win-bash +CC = avr-gcc +OBJCOPY = avr-objcopy +OBJDUMP = avr-objdump +SIZE = avr-size +NM = avr-nm +AVRDUDE = avrdude +REMOVE = rm -rf +COPY = cp +WINSHELL = cmd + + +# Define Messages +MSG_FLASH = Creating load file for Flash: +MSG_EEPROM = Creating load file for EEPROM: +MSG_EXTENDED_LISTING = Creating Extended Listing: +MSG_SYMBOL_TABLE = Creating Symbol Table: +MSG_LINKING = Linking: +MSG_COMPILING = Compiling: +MSG_ASSEMBLING = Assembling: +MSG_CLEANING = Cleaning project: + + + +# Define all object files. +OBJ = $(SRC:.c=.o) $(ASRC:.S=.o) + +# Define all listing files. +LST = $(SRC:.c=.lst) $(ASRC:.S=.lst) + + +# Compiler flags to generate dependency files. +GENDEPFLAGS = -MD -MP -MF .dep/$(@F).d + + +# Combine all necessary flags and optional flags. +# Add target processor to flags. +ALL_CFLAGS = -mmcu=$(MCU) $(CFLAGS) $(GENDEPFLAGS) +ALL_ASFLAGS = -mmcu=$(MCU) -I. $(ASFLAGS) + + +# Default target. +all: gccversion $(TARGET).elf $(TARGET).hex $(TARGET).eep $(TARGET).lss $(TARGET).sym size + + +# Display compiler version information. +gccversion : + @echo $(OBJ1) + @$(CC) --version + + +# Create final output files (.hex, .eep) from ELF output file. +%.hex: %.elf + @echo $(MSG_FLASH) $@ + $(OBJCOPY) -O $(FORMAT) -R .eeprom $< $@ + +%.eep: %.elf + @echo $(MSG_EEPROM) $@ + -$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" --change-section-lma .eeprom=0 -O $(FORMAT) $< $@ + +# Create extended listing file from ELF output file. +%.lss: %.elf + @echo $(MSG_EXTENDED_LISTING) $@ + $(OBJDUMP) -h -S $< > $@ + +# Create a symbol table from ELF output file. +%.sym: %.elf + @echo $(MSG_SYMBOL_TABLE) $@ + $(NM) -n $< > $@ + +# Link: create ELF output file from object files. +.SECONDARY : $(TARGET).elf +.PRECIOUS : $(OBJ) +%.elf: $(OBJ) + @echo $(MSG_LINKING) $@ + $(CC) -mmcu=$(MCU) $(LDFLAGS) $^ --output $(@F) + +# Compile: create object files from C source files. +%.o : %.c + @echo $(MSG_COMPILING) $< + $(CC) -c $(ALL_CFLAGS) $< -o $(@F) + +# Compile: create assembler files from C source files. +%.s : %.c + $(CC) -S $(ALL_CFLAGS) $< -o $(@F) + +# Assemble: create object files from assembler source files. +%.o : %.S + @echo $(MSG_ASSEMBLING) $< + $(CC) -c $(ALL_ASFLAGS) $< -o $(@F) + +# Create preprocessed source for use in sending a bug report. +%.i : %.c + $(CC) -E -mmcu=$(MCU) -I. $(CFLAGS) $< -o $(@F) + + +# Display size of file. +size: ${TARGET}.elf + @avr-size -C --mcu=${MCU} ${TARGET}.elf + + +# Program the device. +program: $(TARGET).hex $(TARGET).eep + $(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH) $(AVRDUDE_WRITE_EEPROM) + + +# Delete all generated files. +clean: + @echo $(MSG_CLEANING) + $(REMOVE) $(TARGET).hex $(TARGET).eep $(TARGET).cof $(TARGET).elf $(TARGET).map $(TARGET).sym $(TARGET).lss $(OBJ) $(LST) $(SRC:.c=.s) $(SRC:.c=.d) $(SRC:.c=.i) .dep/ + + +# Include the dependency files. +#-include $(shell mkdir .dep 2>/dev/null) $(wildcard .dep/*) +-include $(shell mkdir .dep 2>NUL) $(wildcard .dep/*) + + +# Listing of phony targets. +.PHONY : all size gccversion clean program + diff --git a/lab_3/lcdlibrary/doxygen.css b/lab_3/lcdlibrary/doxygen.css new file mode 100644 index 0000000..a000833 --- /dev/null +++ b/lab_3/lcdlibrary/doxygen.css @@ -0,0 +1,1449 @@ +/* The standard CSS for doxygen 1.8.9.1 */ + +body, table, div, p, dl { + font: 400 14px/22px Roboto,sans-serif; +} + +/* @group Heading Levels */ + +h1.groupheader { + font-size: 150%; +} + +.title { + font: 400 14px/28px Roboto,sans-serif; + font-size: 150%; + font-weight: bold; + margin: 10px 2px; +} + +h2.groupheader { + border-bottom: 1px solid #879ECB; + color: #354C7B; + font-size: 150%; + font-weight: normal; + margin-top: 1.75em; + padding-top: 8px; + padding-bottom: 4px; + width: 100%; +} + +h3.groupheader { + font-size: 100%; +} + +h1, h2, h3, h4, h5, h6 { + -webkit-transition: text-shadow 0.5s linear; + -moz-transition: text-shadow 0.5s linear; + -ms-transition: text-shadow 0.5s linear; + -o-transition: text-shadow 0.5s linear; + transition: text-shadow 0.5s linear; + margin-right: 15px; +} + +h1.glow, h2.glow, h3.glow, h4.glow, h5.glow, h6.glow { + text-shadow: 0 0 15px cyan; +} + +dt { + font-weight: bold; +} + +div.multicol { + -moz-column-gap: 1em; + -webkit-column-gap: 1em; + -moz-column-count: 3; + -webkit-column-count: 3; +} + +p.startli, p.startdd { + margin-top: 2px; +} + +p.starttd { + margin-top: 0px; +} + +p.endli { + margin-bottom: 0px; +} + +p.enddd { + margin-bottom: 4px; +} + +p.endtd { + margin-bottom: 2px; +} + +/* @end */ + +caption { + font-weight: bold; +} + +span.legend { + font-size: 70%; + text-align: center; +} + +h3.version { + font-size: 90%; + text-align: center; +} + +div.qindex, div.navtab{ + background-color: #EBEFF6; + border: 1px solid #A3B4D7; + text-align: center; +} + +div.qindex, div.navpath { + width: 100%; + line-height: 140%; +} + +div.navtab { + margin-right: 15px; +} + +/* @group Link Styling */ + +a { + color: #3D578C; + font-weight: normal; + text-decoration: none; +} + +.contents a:visited { + color: #4665A2; +} + +a:hover { + text-decoration: underline; +} + +a.qindex { + font-weight: bold; +} + +a.qindexHL { + font-weight: bold; + background-color: #9CAFD4; + color: #ffffff; + border: 1px double #869DCA; +} + +.contents a.qindexHL:visited { + color: #ffffff; +} + +a.el { + font-weight: bold; +} + +a.elRef { +} + +a.code, a.code:visited, a.line, a.line:visited { + color: #4665A2; +} + +a.codeRef, a.codeRef:visited, a.lineRef, a.lineRef:visited { + color: #4665A2; +} + +/* @end */ + +dl.el { + margin-left: -1cm; +} + +pre.fragment { + border: 1px solid #C4CFE5; + background-color: #FBFCFD; + padding: 4px 6px; + margin: 4px 8px 4px 2px; + overflow: auto; + word-wrap: break-word; + font-size: 9pt; + line-height: 125%; + font-family: monospace, fixed; + font-size: 105%; +} + +div.fragment { + padding: 4px 6px; + margin: 4px 8px 4px 2px; + background-color: #FBFCFD; + border: 1px solid #C4CFE5; +} + +div.line { + font-family: monospace, fixed; + font-size: 13px; + min-height: 13px; + line-height: 1.0; + text-wrap: unrestricted; + white-space: -moz-pre-wrap; /* Moz */ + white-space: -pre-wrap; /* Opera 4-6 */ + white-space: -o-pre-wrap; /* Opera 7 */ + white-space: pre-wrap; /* CSS3 */ + word-wrap: break-word; /* IE 5.5+ */ + text-indent: -53px; + padding-left: 53px; + padding-bottom: 0px; + margin: 0px; + -webkit-transition-property: background-color, box-shadow; + -webkit-transition-duration: 0.5s; + -moz-transition-property: background-color, box-shadow; + -moz-transition-duration: 0.5s; + -ms-transition-property: background-color, box-shadow; + -ms-transition-duration: 0.5s; + -o-transition-property: background-color, box-shadow; + -o-transition-duration: 0.5s; + transition-property: background-color, box-shadow; + transition-duration: 0.5s; +} + +div.line.glow { + background-color: cyan; + box-shadow: 0 0 10px cyan; +} + + +span.lineno { + padding-right: 4px; + text-align: right; + border-right: 2px solid #0F0; + background-color: #E8E8E8; + white-space: pre; +} +span.lineno a { + background-color: #D8D8D8; +} + +span.lineno a:hover { + background-color: #C8C8C8; +} + +div.ah, span.ah { + background-color: black; + font-weight: bold; + color: #ffffff; + margin-bottom: 3px; + margin-top: 3px; + padding: 0.2em; + border: solid thin #333; + border-radius: 0.5em; + -webkit-border-radius: .5em; + -moz-border-radius: .5em; + box-shadow: 2px 2px 3px #999; + -webkit-box-shadow: 2px 2px 3px #999; + -moz-box-shadow: rgba(0, 0, 0, 0.15) 2px 2px 2px; + background-image: -webkit-gradient(linear, left top, left bottom, from(#eee), to(#000),color-stop(0.3, #444)); + background-image: -moz-linear-gradient(center top, #eee 0%, #444 40%, #000); +} + +div.classindex ul { + list-style: none; + padding-left: 0; +} + +div.classindex span.ai { + display: inline-block; +} + +div.groupHeader { + margin-left: 16px; + margin-top: 12px; + font-weight: bold; +} + +div.groupText { + margin-left: 16px; + font-style: italic; +} + +body { + background-color: white; + color: black; + margin: 0; +} + +div.contents { + margin-top: 10px; + margin-left: 12px; + margin-right: 8px; +} + +td.indexkey { + background-color: #EBEFF6; + font-weight: bold; + border: 1px solid #C4CFE5; + margin: 2px 0px 2px 0; + padding: 2px 10px; + white-space: nowrap; + vertical-align: top; +} + +td.indexvalue { + background-color: #EBEFF6; + border: 1px solid #C4CFE5; + padding: 2px 10px; + margin: 2px 0px; +} + +tr.memlist { + background-color: #EEF1F7; +} + +p.formulaDsp { + text-align: center; +} + +img.formulaDsp { + +} + +img.formulaInl { + vertical-align: middle; +} + +div.center { + text-align: center; + margin-top: 0px; + margin-bottom: 0px; + padding: 0px; +} + +div.center img { + border: 0px; +} + +address.footer { + text-align: right; + padding-right: 12px; +} + +img.footer { + border: 0px; + vertical-align: middle; +} + +/* @group Code Colorization */ + +span.keyword { + color: #008000 +} + +span.keywordtype { + color: #604020 +} + +span.keywordflow { + color: #e08000 +} + +span.comment { + color: #800000 +} + +span.preprocessor { + color: #806020 +} + +span.stringliteral { + color: #002080 +} + +span.charliteral { + color: #008080 +} + +span.vhdldigit { + color: #ff00ff +} + +span.vhdlchar { + color: #000000 +} + +span.vhdlkeyword { + color: #700070 +} + +span.vhdllogic { + color: #ff0000 +} + +blockquote { + background-color: #F7F8FB; + border-left: 2px solid #9CAFD4; + margin: 0 24px 0 4px; + padding: 0 12px 0 16px; +} + +/* @end */ + +/* +.search { + color: #003399; + font-weight: bold; +} + +form.search { + margin-bottom: 0px; + margin-top: 0px; +} + +input.search { + font-size: 75%; + color: #000080; + font-weight: normal; + background-color: #e8eef2; +} +*/ + +td.tiny { + font-size: 75%; +} + +.dirtab { + padding: 4px; + border-collapse: collapse; + border: 1px solid #A3B4D7; +} + +th.dirtab { + background: #EBEFF6; + font-weight: bold; +} + +hr { + height: 0px; + border: none; + border-top: 1px solid #4A6AAA; +} + +hr.footer { + height: 1px; +} + +/* @group Member Descriptions */ + +table.memberdecls { + border-spacing: 0px; + padding: 0px; +} + +.memberdecls td, .fieldtable tr { + -webkit-transition-property: background-color, box-shadow; + -webkit-transition-duration: 0.5s; + -moz-transition-property: background-color, box-shadow; + -moz-transition-duration: 0.5s; + -ms-transition-property: background-color, box-shadow; + -ms-transition-duration: 0.5s; + -o-transition-property: background-color, box-shadow; + -o-transition-duration: 0.5s; + transition-property: background-color, box-shadow; + transition-duration: 0.5s; +} + +.memberdecls td.glow, .fieldtable tr.glow { + background-color: cyan; + box-shadow: 0 0 15px cyan; +} + +.mdescLeft, .mdescRight, +.memItemLeft, .memItemRight, +.memTemplItemLeft, .memTemplItemRight, .memTemplParams { + background-color: #F9FAFC; + border: none; + margin: 4px; + padding: 1px 0 0 8px; +} + +.mdescLeft, .mdescRight { + padding: 0px 8px 4px 8px; + color: #555; +} + +.memSeparator { + border-bottom: 1px solid #DEE4F0; + line-height: 1px; + margin: 0px; + padding: 0px; +} + +.memItemLeft, .memTemplItemLeft { + white-space: nowrap; +} + +.memItemRight { + width: 100%; +} + +.memTemplParams { + color: #4665A2; + white-space: nowrap; + font-size: 80%; +} + +/* @end */ + +/* @group Member Details */ + +/* Styles for detailed member documentation */ + +.memtemplate { + font-size: 80%; + color: #4665A2; + font-weight: normal; + margin-left: 9px; +} + +.memnav { + background-color: #EBEFF6; + border: 1px solid #A3B4D7; + text-align: center; + margin: 2px; + margin-right: 15px; + padding: 2px; +} + +.mempage { + width: 100%; +} + +.memitem { + padding: 0; + margin-bottom: 10px; + margin-right: 5px; + -webkit-transition: box-shadow 0.5s linear; + -moz-transition: box-shadow 0.5s linear; + -ms-transition: box-shadow 0.5s linear; + -o-transition: box-shadow 0.5s linear; + transition: box-shadow 0.5s linear; + display: table !important; + width: 100%; +} + +.memitem.glow { + box-shadow: 0 0 15px cyan; +} + +.memname { + font-weight: bold; + margin-left: 6px; +} + +.memname td { + vertical-align: bottom; +} + +.memproto, dl.reflist dt { + border-top: 1px solid #A8B8D9; + border-left: 1px solid #A8B8D9; + border-right: 1px solid #A8B8D9; + padding: 6px 0px 6px 0px; + color: #253555; + font-weight: bold; + text-shadow: 0px 1px 1px rgba(255, 255, 255, 0.9); + background-image:url('nav_f.png'); + background-repeat:repeat-x; + background-color: #E2E8F2; + /* opera specific markup */ + box-shadow: 5px 5px 5px rgba(0, 0, 0, 0.15); + border-top-right-radius: 4px; + border-top-left-radius: 4px; + /* firefox specific markup */ + -moz-box-shadow: rgba(0, 0, 0, 0.15) 5px 5px 5px; + -moz-border-radius-topright: 4px; + -moz-border-radius-topleft: 4px; + /* webkit specific markup */ + -webkit-box-shadow: 5px 5px 5px rgba(0, 0, 0, 0.15); + -webkit-border-top-right-radius: 4px; + -webkit-border-top-left-radius: 4px; + +} + +.memdoc, dl.reflist dd { + border-bottom: 1px solid #A8B8D9; + border-left: 1px solid #A8B8D9; + border-right: 1px solid #A8B8D9; + padding: 6px 10px 2px 10px; + background-color: #FBFCFD; + border-top-width: 0; + background-image:url('nav_g.png'); + background-repeat:repeat-x; + background-color: #FFFFFF; + /* opera specific markup */ + border-bottom-left-radius: 4px; + border-bottom-right-radius: 4px; + box-shadow: 5px 5px 5px rgba(0, 0, 0, 0.15); + /* firefox specific markup */ + -moz-border-radius-bottomleft: 4px; + -moz-border-radius-bottomright: 4px; + -moz-box-shadow: rgba(0, 0, 0, 0.15) 5px 5px 5px; + /* webkit specific markup */ + -webkit-border-bottom-left-radius: 4px; + -webkit-border-bottom-right-radius: 4px; + -webkit-box-shadow: 5px 5px 5px rgba(0, 0, 0, 0.15); +} + +dl.reflist dt { + padding: 5px; +} + +dl.reflist dd { + margin: 0px 0px 10px 0px; + padding: 5px; +} + +.paramkey { + text-align: right; +} + +.paramtype { + white-space: nowrap; +} + +.paramname { + color: #602020; + white-space: nowrap; +} +.paramname em { + font-style: normal; +} +.paramname code { + line-height: 14px; +} + +.params, .retval, .exception, .tparams { + margin-left: 0px; + padding-left: 0px; +} + +.params .paramname, .retval .paramname { + font-weight: bold; + vertical-align: top; +} + +.params .paramtype { + font-style: italic; + vertical-align: top; +} + +.params .paramdir { + font-family: "courier new",courier,monospace; + vertical-align: top; +} + +table.mlabels { + border-spacing: 0px; +} + +td.mlabels-left { + width: 100%; + padding: 0px; +} + +td.mlabels-right { + vertical-align: bottom; + padding: 0px; + white-space: nowrap; +} + +span.mlabels { + margin-left: 8px; +} + +span.mlabel { + background-color: #728DC1; + border-top:1px solid #5373B4; + border-left:1px solid #5373B4; + border-right:1px solid #C4CFE5; + border-bottom:1px solid #C4CFE5; + text-shadow: none; + color: white; + margin-right: 4px; + padding: 2px 3px; + border-radius: 3px; + font-size: 7pt; + white-space: nowrap; + vertical-align: middle; +} + + + +/* @end */ + +/* these are for tree view inside a (index) page */ + +div.directory { + margin: 10px 0px; + border-top: 1px solid #9CAFD4; + border-bottom: 1px solid #9CAFD4; + width: 100%; +} + +.directory table { + border-collapse:collapse; +} + +.directory td { + margin: 0px; + padding: 0px; + vertical-align: top; +} + +.directory td.entry { + white-space: nowrap; + padding-right: 6px; + padding-top: 3px; +} + +.directory td.entry a { + outline:none; +} + +.directory td.entry a img { + border: none; +} + +.directory td.desc { + width: 100%; + padding-left: 6px; + padding-right: 6px; + padding-top: 3px; + border-left: 1px solid rgba(0,0,0,0.05); +} + +.directory tr.even { + padding-left: 6px; + background-color: #F7F8FB; +} + +.directory img { + vertical-align: -30%; +} + +.directory .levels { + white-space: nowrap; + width: 100%; + text-align: right; + font-size: 9pt; +} + +.directory .levels span { + cursor: pointer; + padding-left: 2px; + padding-right: 2px; + color: #3D578C; +} + +.arrow { + color: #9CAFD4; + -webkit-user-select: none; + -khtml-user-select: none; + -moz-user-select: none; + -ms-user-select: none; + user-select: none; + cursor: pointer; + font-size: 80%; + display: inline-block; + width: 16px; + height: 22px; +} + +.icon { + font-family: Arial, Helvetica; + font-weight: bold; + font-size: 12px; + height: 14px; + width: 16px; + display: inline-block; + background-color: #728DC1; + color: white; + text-align: center; + border-radius: 4px; + margin-left: 2px; + margin-right: 2px; +} + +.icona { + width: 24px; + height: 22px; + display: inline-block; +} + +.iconfopen { + width: 24px; + height: 18px; + margin-bottom: 4px; + background-image:url('folderopen.png'); + background-position: 0px -4px; + background-repeat: repeat-y; + vertical-align:top; + display: inline-block; +} + +.iconfclosed { + width: 24px; + height: 18px; + margin-bottom: 4px; + background-image:url('folderclosed.png'); + background-position: 0px -4px; + background-repeat: repeat-y; + vertical-align:top; + display: inline-block; +} + +.icondoc { + width: 24px; + height: 18px; + margin-bottom: 4px; + background-image:url('doc.png'); + background-position: 0px -4px; + background-repeat: repeat-y; + vertical-align:top; + display: inline-block; +} + +table.directory { + font: 400 14px Roboto,sans-serif; +} + +/* @end */ + +div.dynheader { + margin-top: 8px; + -webkit-touch-callout: none; + -webkit-user-select: none; + -khtml-user-select: none; + -moz-user-select: none; + -ms-user-select: none; + user-select: none; +} + +address { + font-style: normal; + color: #2A3D61; +} + +table.doxtable { + border-collapse:collapse; + margin-top: 4px; + margin-bottom: 4px; +} + +table.doxtable td, table.doxtable th { + border: 1px solid #2D4068; + padding: 3px 7px 2px; +} + +table.doxtable th { + background-color: #374F7F; + color: #FFFFFF; + font-size: 110%; + padding-bottom: 4px; + padding-top: 5px; +} + +table.fieldtable { + /*width: 100%;*/ + margin-bottom: 10px; + border: 1px solid #A8B8D9; + border-spacing: 0px; + -moz-border-radius: 4px; + -webkit-border-radius: 4px; + border-radius: 4px; + -moz-box-shadow: rgba(0, 0, 0, 0.15) 2px 2px 2px; + -webkit-box-shadow: 2px 2px 2px rgba(0, 0, 0, 0.15); + box-shadow: 2px 2px 2px rgba(0, 0, 0, 0.15); +} + +.fieldtable td, .fieldtable th { + padding: 3px 7px 2px; +} + +.fieldtable td.fieldtype, .fieldtable td.fieldname { + white-space: nowrap; + border-right: 1px solid #A8B8D9; + border-bottom: 1px solid #A8B8D9; + vertical-align: top; +} + +.fieldtable td.fieldname { + padding-top: 3px; +} + +.fieldtable td.fielddoc { + border-bottom: 1px solid #A8B8D9; + /*width: 100%;*/ +} + +.fieldtable td.fielddoc p:first-child { + margin-top: 0px; +} + +.fieldtable td.fielddoc p:last-child { + margin-bottom: 2px; +} + +.fieldtable tr:last-child td { + border-bottom: none; +} + +.fieldtable th { + background-image:url('nav_f.png'); + background-repeat:repeat-x; + background-color: #E2E8F2; + font-size: 90%; + color: #253555; + padding-bottom: 4px; + padding-top: 5px; + text-align:left; + -moz-border-radius-topleft: 4px; + -moz-border-radius-topright: 4px; + -webkit-border-top-left-radius: 4px; + -webkit-border-top-right-radius: 4px; + border-top-left-radius: 4px; + border-top-right-radius: 4px; + border-bottom: 1px solid #A8B8D9; +} + + +.tabsearch { + top: 0px; + left: 10px; + height: 36px; + background-image: url('tab_b.png'); + z-index: 101; + overflow: hidden; + font-size: 13px; +} + +.navpath ul +{ + font-size: 11px; + background-image:url('tab_b.png'); + background-repeat:repeat-x; + background-position: 0 -5px; + height:30px; + line-height:30px; + color:#8AA0CC; + border:solid 1px #C2CDE4; + overflow:hidden; + margin:0px; + padding:0px; +} + +.navpath li +{ + list-style-type:none; + float:left; + padding-left:10px; + padding-right:15px; + background-image:url('bc_s.png'); + background-repeat:no-repeat; + background-position:right; + color:#364D7C; +} + +.navpath li.navelem a +{ + height:32px; + display:block; + text-decoration: none; + outline: none; + color: #283A5D; + font-family: 'Lucida Grande',Geneva,Helvetica,Arial,sans-serif; + text-shadow: 0px 1px 1px rgba(255, 255, 255, 0.9); + text-decoration: none; +} + +.navpath li.navelem a:hover +{ + color:#6884BD; +} + +.navpath li.footer +{ + list-style-type:none; + float:right; + padding-left:10px; + padding-right:15px; + background-image:none; + background-repeat:no-repeat; + background-position:right; + color:#364D7C; + font-size: 8pt; +} + + +div.summary +{ + float: right; + font-size: 8pt; + padding-right: 5px; + width: 50%; + text-align: right; +} + +div.summary a +{ + white-space: nowrap; +} + +div.ingroups +{ + font-size: 8pt; + width: 50%; + text-align: left; +} + +div.ingroups a +{ + white-space: nowrap; +} + +div.header +{ + background-image:url('nav_h.png'); + background-repeat:repeat-x; + background-color: #F9FAFC; + margin: 0px; + border-bottom: 1px solid #C4CFE5; +} + +div.headertitle +{ + padding: 5px 5px 5px 10px; +} + +dl +{ + padding: 0 0 0 10px; +} + +/* dl.note, dl.warning, dl.attention, dl.pre, dl.post, dl.invariant, dl.deprecated, dl.todo, dl.test, dl.bug */ +dl.section +{ + margin-left: 0px; + padding-left: 0px; +} + +dl.note +{ + margin-left:-7px; + padding-left: 3px; + border-left:4px solid; + border-color: #D0C000; +} + +dl.warning, dl.attention +{ + margin-left:-7px; + padding-left: 3px; + border-left:4px solid; + border-color: #FF0000; +} + +dl.pre, dl.post, dl.invariant +{ + margin-left:-7px; + padding-left: 3px; + border-left:4px solid; + border-color: #00D000; +} + +dl.deprecated +{ + margin-left:-7px; + padding-left: 3px; + border-left:4px solid; + border-color: #505050; +} + +dl.todo +{ + margin-left:-7px; + padding-left: 3px; + border-left:4px solid; + border-color: #00C0E0; +} + +dl.test +{ + margin-left:-7px; + padding-left: 3px; + border-left:4px solid; + border-color: #3030E0; +} + +dl.bug +{ + margin-left:-7px; + padding-left: 3px; + border-left:4px solid; + border-color: #C08050; +} + +dl.section dd { + margin-bottom: 6px; +} + + +#projectlogo +{ + text-align: center; + vertical-align: bottom; + border-collapse: separate; +} + +#projectlogo img +{ + border: 0px none; +} + +#projectname +{ + font: 300% Tahoma, Arial,sans-serif; + margin: 0px; + padding: 2px 0px; +} + +#projectbrief +{ + font: 120% Tahoma, Arial,sans-serif; + margin: 0px; + padding: 0px; +} + +#projectnumber +{ + font: 50% Tahoma, Arial,sans-serif; + margin: 0px; + padding: 0px; +} + +#titlearea +{ + padding: 0px; + margin: 0px; + width: 100%; + border-bottom: 1px solid #5373B4; +} + +.image +{ + text-align: center; +} + +.dotgraph +{ + text-align: center; +} + +.mscgraph +{ + text-align: center; +} + +.diagraph +{ + text-align: center; +} + +.caption +{ + font-weight: bold; +} + +div.zoom +{ + border: 1px solid #90A5CE; +} + +dl.citelist { + margin-bottom:50px; +} + +dl.citelist dt { + color:#334975; + float:left; + font-weight:bold; + margin-right:10px; + padding:5px; +} + +dl.citelist dd { + margin:2px 0; + padding:5px 0; +} + +div.toc { + padding: 14px 25px; + background-color: #F4F6FA; + border: 1px solid #D8DFEE; + border-radius: 7px 7px 7px 7px; + float: right; + height: auto; + margin: 0 20px 10px 10px; + width: 200px; +} + +div.toc li { + background: url("bdwn.png") no-repeat scroll 0 5px transparent; + font: 10px/1.2 Verdana,DejaVu Sans,Geneva,sans-serif; + margin-top: 5px; + padding-left: 10px; + padding-top: 2px; +} + +div.toc h3 { + font: bold 12px/1.2 Arial,FreeSans,sans-serif; + color: #4665A2; + border-bottom: 0 none; + margin: 0; +} + +div.toc ul { + list-style: none outside none; + border: medium none; + padding: 0px; +} + +div.toc li.level1 { + margin-left: 0px; +} + +div.toc li.level2 { + margin-left: 15px; +} + +div.toc li.level3 { + margin-left: 30px; +} + +div.toc li.level4 { + margin-left: 45px; +} + +.inherit_header { + font-weight: bold; + color: gray; + cursor: pointer; + -webkit-touch-callout: none; + -webkit-user-select: none; + -khtml-user-select: none; + -moz-user-select: none; + -ms-user-select: none; + user-select: none; +} + +.inherit_header td { + padding: 6px 0px 2px 5px; +} + +.inherit { + display: none; +} + +tr.heading h2 { + margin-top: 12px; + margin-bottom: 4px; +} + +/* tooltip related style info */ + +.ttc { + position: absolute; + display: none; +} + +#powerTip { + cursor: default; + white-space: nowrap; + background-color: white; + border: 1px solid gray; + border-radius: 4px 4px 4px 4px; + box-shadow: 1px 1px 7px gray; + display: none; + font-size: smaller; + max-width: 80%; + opacity: 0.9; + padding: 1ex 1em 1em; + position: absolute; + z-index: 2147483647; +} + +#powerTip div.ttdoc { + color: grey; + font-style: italic; +} + +#powerTip div.ttname a { + font-weight: bold; +} + +#powerTip div.ttname { + font-weight: bold; +} + +#powerTip div.ttdeci { + color: #006318; +} + +#powerTip div { + margin: 0px; + padding: 0px; + font: 12px/16px Roboto,sans-serif; +} + +#powerTip:before, #powerTip:after { + content: ""; + position: absolute; + margin: 0px; +} + +#powerTip.n:after, #powerTip.n:before, +#powerTip.s:after, #powerTip.s:before, +#powerTip.w:after, #powerTip.w:before, +#powerTip.e:after, #powerTip.e:before, +#powerTip.ne:after, #powerTip.ne:before, +#powerTip.se:after, #powerTip.se:before, +#powerTip.nw:after, #powerTip.nw:before, +#powerTip.sw:after, #powerTip.sw:before { + border: solid transparent; + content: " "; + height: 0; + width: 0; + position: absolute; +} + +#powerTip.n:after, #powerTip.s:after, +#powerTip.w:after, #powerTip.e:after, +#powerTip.nw:after, #powerTip.ne:after, +#powerTip.sw:after, #powerTip.se:after { + border-color: rgba(255, 255, 255, 0); +} + +#powerTip.n:before, #powerTip.s:before, +#powerTip.w:before, #powerTip.e:before, +#powerTip.nw:before, #powerTip.ne:before, +#powerTip.sw:before, #powerTip.se:before { + border-color: rgba(128, 128, 128, 0); +} + +#powerTip.n:after, #powerTip.n:before, +#powerTip.ne:after, #powerTip.ne:before, +#powerTip.nw:after, #powerTip.nw:before { + top: 100%; +} + +#powerTip.n:after, #powerTip.ne:after, #powerTip.nw:after { + border-top-color: #ffffff; + border-width: 10px; + margin: 0px -10px; +} +#powerTip.n:before { + border-top-color: #808080; + border-width: 11px; + margin: 0px -11px; +} +#powerTip.n:after, #powerTip.n:before { + left: 50%; +} + +#powerTip.nw:after, #powerTip.nw:before { + right: 14px; +} + +#powerTip.ne:after, #powerTip.ne:before { + left: 14px; +} + +#powerTip.s:after, #powerTip.s:before, +#powerTip.se:after, #powerTip.se:before, +#powerTip.sw:after, #powerTip.sw:before { + bottom: 100%; +} + +#powerTip.s:after, #powerTip.se:after, #powerTip.sw:after { + border-bottom-color: #ffffff; + border-width: 10px; + margin: 0px -10px; +} + +#powerTip.s:before, #powerTip.se:before, #powerTip.sw:before { + border-bottom-color: #808080; + border-width: 11px; + margin: 0px -11px; +} + +#powerTip.s:after, #powerTip.s:before { + left: 50%; +} + +#powerTip.sw:after, #powerTip.sw:before { + right: 14px; +} + +#powerTip.se:after, #powerTip.se:before { + left: 14px; +} + +#powerTip.e:after, #powerTip.e:before { + left: 100%; +} +#powerTip.e:after { + border-left-color: #ffffff; + border-width: 10px; + top: 50%; + margin-top: -10px; +} +#powerTip.e:before { + border-left-color: #808080; + border-width: 11px; + top: 50%; + margin-top: -11px; +} + +#powerTip.w:after, #powerTip.w:before { + right: 100%; +} +#powerTip.w:after { + border-right-color: #ffffff; + border-width: 10px; + top: 50%; + margin-top: -10px; +} +#powerTip.w:before { + border-right-color: #808080; + border-width: 11px; + top: 50%; + margin-top: -11px; +} + +@media print +{ + #top { display: none; } + #side-nav { display: none; } + #nav-path { display: none; } + body { overflow:visible; } + h1, h2, h3, h4, h5, h6 { page-break-after: avoid; } + .summary { display: none; } + .memitem { page-break-inside: avoid; } + #doc-content + { + margin-left:0 !important; + height:auto !important; + width:auto !important; + overflow:inherit; + display:inline; + } +} + diff --git a/lab_3/lcdlibrary/doxygen.png b/lab_3/lcdlibrary/doxygen.png new file mode 100644 index 0000000000000000000000000000000000000000..3ff17d807fd8aa003bed8bb2a69e8f0909592fd1 GIT binary patch literal 3779 zcmV;!4m|ORP)tMIv#Q0*~7*`IBSO7_x;@a8#Zk6_PeKR_s92J&)(m+);m9Iz3blw)z#Gi zP!9lj4$%+*>Hz@HCmM9L9|8c+0u=!H$O3?R0Kgx|#WP<6fKfC8fM-CQZT|_r@`>VO zX^Hgb|9cJqpdJA5$MCEK`F_2@2Y@s>^+;pF`~jdI0Pvr|vl4`=C)EH@1IFe7pdJ8F zH(qGi004~QnF)Ggga~8v08kGAs2hKTATxr7pwfNk|4#_AaT>w8P6TV+R2kbS$v==} zAjf`s0g#V8lB+b3)5oEI*q+{Yt$MZDruD2^;$+(_%Qn+%v0X-bJO=;@kiJ^ygLBnC z?1OVv_%aex1M@jKU|Z~$eI?PoF4Vj>fDzyo zAiLfpXY*a^Sj-S5D0S3@#V$sRW)g)_1e#$%8xdM>Jm7?!h zu0P2X=xoN>^!4DoPRgph2(2va07yfpXF+WH7EOg1GY%Zn z7~1A<(z7Q$ktEXhW_?GMpHp9l_UL18F3KOsxu81pqoBiNbFSGsof-W z6~eloMoz=4?OOnl2J268x5rOY`dCk0us(uS#Ud4yqOr@?=Q57a}tit|BhY>}~frH1sP`ScHS_d)oqH^lYy zZ%VP`#10MlE~P?cE(%(#(AUSv_T{+;t@$U}El}(1ig`vZo`Rm;+5&(AYzJ^Ae=h2X z@Re%vHwZU>|f0NI&%$*4eJweC5OROQrpPMA@*w|o z()A==l}(@bv^&>H1Ob3C=<^|hob?0+xJ?QQ3-ueQC}zy&JQNib!OqSO@-=>XzxlSF zAZ^U*1l6EEmg3r};_HY>&Jo_{dOPEFTWPmt=U&F#+0(O59^UIlHbNX+eF8UzyDR*T z(=5X$VF3!gm@RooS-&iiUYGG^`hMR(07zr_xP`d!^BH?uD>Phl8Rdifx3Af^Zr`Ku ztL+~HkVeL#bJ)7;`=>;{KNRvjmc}1}c58Sr#Treq=4{xo!ATy|c>iRSp4`dzMMVd@ zL8?uwXDY}Wqgh4mH`|$BTXpUIu6A1-cSq%hJw;@^Zr8TP=GMh*p(m(tN7@!^D~sl$ zz^tf4II4|};+irE$Fnm4NTc5%p{PRA`%}Zk`CE5?#h3|xcyQsS#iONZ z6H(@^i9td!$z~bZiJLTax$o>r(p}3o@< zyD7%(>ZYvy=6$U3e!F{Z`uSaYy`xQyl?b{}eg|G3&fz*`QH@mDUn)1%#5u`0m$%D} z?;tZ0u(mWeMV0QtzjgN!lT*pNRj;6510Wwx?Yi_=tYw|J#7@(Xe7ifDzXuK;JB;QO z#bg~K$cgm$@{QiL_3yr}y&~wuv=P=#O&Tj=Sr)aCUlYmZMcw?)T?c%0rUe1cS+o!qs_ zQ6Gp)-{)V!;=q}llyK3|^WeLKyjf%y;xHku;9(vM!j|~<7w1c*Mk-;P{T&yG) z@C-8E?QPynNQ<8f01D`2qexcVEIOU?y}MG)TAE6&VT5`rK8s(4PE;uQ92LTXUQ<>^ ztyQ@=@kRdh@ebUG^Z6NWWIL;_IGJ2ST>$t!$m$qvtj0Qmw8moN6GUV^!QKNK zHBXCtUH8)RY9++gH_TUV4^=-j$t}dD3qsN7GclJ^Zc&(j6&a_!$jCf}%c5ey`pm~1)@{yI3 zTdWyB+*X{JFw#z;PwRr5evb2!ueWF;v`B0HoUu4-(~aL=z;OXUUEtG`_$)Oxw6FKg zEzY`CyKaSBK3xt#8gA|r_|Kehn_HYVBMpEwbn9-fI*!u*eTA1ef8Mkl1=!jV4oYwWYM}i`A>_F4nhmlCIC6WLa zY%;4&@AlnaG11ejl61Jev21|r*m+?Kru3;1tFDl}#!OzUp6c>go4{C|^erwpG*&h6bspUPJag}oOkN2912Y3I?(eRc@U9>z#HPBHC?nps7H5!zP``90!Q1n80jo+B3TWXp!8Pe zwuKuLLI6l3Gv@+QH*Y}2wPLPQ1^EZhT#+Ed8q8Wo z1pTmIBxv14-{l&QVKxAyQF#8Q@NeJwWdKk>?cpiJLkJr+aZ!Me+Cfp!?FWSRf^j2k z73BRR{WSKaMkJ>1Nbx5dan5hg^_}O{Tj6u%iV%#QGz0Q@j{R^Ik)Z*+(YvY2ziBG)?AmJa|JV%4UT$k`hcOg5r9R?5>?o~JzK zJCrj&{i#hG>N7!B4kNX(%igb%kDj0fOQThC-8mtfap82PNRXr1D>lbgg)dYTQ(kbx z`Ee5kXG~Bh+BHQBf|kJEy6(ga%WfhvdQNDuOfQoe377l#ht&DrMGeIsI5C<&ai zWG$|hop2@@q5YDa)_-A?B02W;#fH!%k`daQLEItaJJ8Yf1L%8x;kg?)k)00P-lH+w z)5$QNV6r2$YtnV(4o=0^3{kmaXn*Dm0F*fU(@o)yVVjk|ln8ea6BMy%vZAhW9|wvA z8RoDkVoMEz1d>|5(k0Nw>22ZT){V<3$^C-cN+|~hKt2)){+l-?3m@-$c?-dlzQ)q- zZ)j%n^gerV{|+t}9m1_&&Ly!9$rtG4XX|WQ8`xYzGC~U@nYh~g(z9)bdAl#xH)xd5a=@|qql z|FzEil{P5(@gy!4ek05i$>`E^G~{;pnf6ftpLh$h#W?^#4UkPfa;;?bsIe&kz!+40 zI|6`F2n020)-r`pFaZ38F!S-lJM-o&inOw|66=GMeP@xQU5ghQH{~5Uh~TMTd;I9` z>YhVB`e^EVj*S7JF39ZgNf}A-0DwOcTT63ydN$I3b?yBQtUI*_fae~kPvzoD$zjX3 zoqBe#>12im4WzZ=f^4+u=!lA|#r%1`WB0-6*3BL#at`47#ebPpR|D1b)3BjT34nYY z%Ds%d?5$|{LgOIaRO{{oC&RK`O91$fqwM0(C_TALcozu*fWHb%%q&p-q{_8*2Zsi^ zh1ZCnr^UYa;4vQEtHk{~zi>wwMC5o{S=$P0X681y`SXwFH?Ewn{x-MOZynmc)JT5v zuHLwh;tLfxRrr%|k370}GofLl7thg>ACWWY&msqaVu&ry+`7+Ss>NL^%T1|z{IGMA zW-SKl=V-^{(f!Kf^#3(|T2W47d(%JVCI4JgRrT1pNz>+ietmFToNv^`gzC@&O-)+i zPQ~RwK8%C_vf%;%e>NyTp~dM5;!C|N0Q^6|CEb7Bw=Vz~$1#FA;Z*?mKSC)Hl-20s t8QyHj(g6VK0RYbl8UjE)0O0w=e*@m04r>stuEhWV002ovPDHLkV1hl;dM*F} literal 0 HcmV?d00001 diff --git a/lab_3/lcdlibrary/lcd.c b/lab_3/lcdlibrary/lcd.c new file mode 100644 index 0000000..8d7eb9c --- /dev/null +++ b/lab_3/lcdlibrary/lcd.c @@ -0,0 +1,592 @@ +/**************************************************************************** + Title: HD44780U LCD library + Author: Peter Fleury http://tinyurl.com/peterfleury + File: $Id: lcd.c,v 1.15.2.2 2015/01/17 12:16:05 peter Exp $ + Software: AVR-GCC 3.3 + Target: any AVR device, memory mapped mode only for AT90S4414/8515/Mega + + DESCRIPTION + Basic routines for interfacing a HD44780U-based text lcd display + + Originally based on Volker Oth's lcd library, + changed lcd_init(), added additional constants for lcd_command(), + added 4-bit I/O mode, improved and optimized code. + + Library can be operated in memory mapped mode (LCD_IO_MODE=0) or in + 4-bit IO port mode (LCD_IO_MODE=1). 8-bit IO port mode not supported. + + Memory mapped mode compatible with Kanda STK200, but supports also + generation of R/W signal through A8 address line. + + USAGE + See the C include lcd.h file for a description of each function + +*****************************************************************************/ +#include +#include +#include +#include +#include "lcd.h" + + + +/* +** constants/macros +*/ +#define DDR(x) (*(&x - 1)) /* address of data direction register of port x */ +#if defined(__AVR_ATmega64__) || defined(__AVR_ATmega128__) + /* on ATmega64/128 PINF is on port 0x00 and not 0x60 */ + #define PIN(x) ( &PORTF==&(x) ? _SFR_IO8(0x00) : (*(&x - 2)) ) +#else + #define PIN(x) (*(&x - 2)) /* address of input register of port x */ +#endif + + +#if LCD_IO_MODE +#define lcd_e_delay() _delay_us(LCD_DELAY_ENABLE_PULSE) +#define lcd_e_high() LCD_E_PORT |= _BV(LCD_E_PIN); +#define lcd_e_low() LCD_E_PORT &= ~_BV(LCD_E_PIN); +#define lcd_e_toggle() toggle_e() +#define lcd_rw_high() LCD_RW_PORT |= _BV(LCD_RW_PIN) +#define lcd_rw_low() LCD_RW_PORT &= ~_BV(LCD_RW_PIN) +#define lcd_rs_high() LCD_RS_PORT |= _BV(LCD_RS_PIN) +#define lcd_rs_low() LCD_RS_PORT &= ~_BV(LCD_RS_PIN) +#endif + +#if LCD_IO_MODE +#if LCD_LINES==1 +#define LCD_FUNCTION_DEFAULT LCD_FUNCTION_4BIT_1LINE +#else +#define LCD_FUNCTION_DEFAULT LCD_FUNCTION_4BIT_2LINES +#endif +#else +#if LCD_LINES==1 +#define LCD_FUNCTION_DEFAULT LCD_FUNCTION_8BIT_1LINE +#else +#define LCD_FUNCTION_DEFAULT LCD_FUNCTION_8BIT_2LINES +#endif +#endif + +#if LCD_CONTROLLER_KS0073 +#if LCD_LINES==4 + +#define KS0073_EXTENDED_FUNCTION_REGISTER_ON 0x2C /* |0|010|1100 4-bit mode, extension-bit RE = 1 */ +#define KS0073_EXTENDED_FUNCTION_REGISTER_OFF 0x28 /* |0|010|1000 4-bit mode, extension-bit RE = 0 */ +#define KS0073_4LINES_MODE 0x09 /* |0|000|1001 4 lines mode */ + +#endif +#endif + +/* +** function prototypes +*/ +#if LCD_IO_MODE +static void toggle_e(void); +#endif + +/* +** local functions +*/ + + +/************************************************************************* +delay for a minimum of microseconds +the number of loops is calculated at compile-time from MCU clock frequency +*************************************************************************/ +#define delay(us) _delay_us(us) + + +#if LCD_IO_MODE +/* toggle Enable Pin to initiate write */ +static void toggle_e(void) +{ + lcd_e_high(); + lcd_e_delay(); + lcd_e_low(); +} +#endif + + +/************************************************************************* +Low-level function to write byte to LCD controller +Input: data byte to write to LCD + rs 1: write data + 0: write instruction +Returns: none +*************************************************************************/ +#if LCD_IO_MODE +static void lcd_write(uint8_t data,uint8_t rs) +{ + unsigned char dataBits ; + + + if (rs) { /* write data (RS=1, RW=0) */ + lcd_rs_high(); + } else { /* write instruction (RS=0, RW=0) */ + lcd_rs_low(); + } + lcd_rw_low(); /* RW=0 write mode */ + + if ( ( &LCD_DATA0_PORT == &LCD_DATA1_PORT) && ( &LCD_DATA1_PORT == &LCD_DATA2_PORT ) && ( &LCD_DATA2_PORT == &LCD_DATA3_PORT ) + && (LCD_DATA0_PIN == 0) && (LCD_DATA1_PIN == 1) && (LCD_DATA2_PIN == 2) && (LCD_DATA3_PIN == 3) ) + { + /* configure data pins as output */ + DDR(LCD_DATA0_PORT) |= 0x0F; + + /* output high nibble first */ + dataBits = LCD_DATA0_PORT & 0xF0; + LCD_DATA0_PORT = dataBits |((data>>4)&0x0F); + lcd_e_toggle(); + + /* output low nibble */ + LCD_DATA0_PORT = dataBits | (data&0x0F); + lcd_e_toggle(); + + /* all data pins high (inactive) */ + LCD_DATA0_PORT = dataBits | 0x0F; + } + else + { + /* configure data pins as output */ + DDR(LCD_DATA0_PORT) |= _BV(LCD_DATA0_PIN); + DDR(LCD_DATA1_PORT) |= _BV(LCD_DATA1_PIN); + DDR(LCD_DATA2_PORT) |= _BV(LCD_DATA2_PIN); + DDR(LCD_DATA3_PORT) |= _BV(LCD_DATA3_PIN); + + /* output high nibble first */ + LCD_DATA3_PORT &= ~_BV(LCD_DATA3_PIN); + LCD_DATA2_PORT &= ~_BV(LCD_DATA2_PIN); + LCD_DATA1_PORT &= ~_BV(LCD_DATA1_PIN); + LCD_DATA0_PORT &= ~_BV(LCD_DATA0_PIN); + if(data & 0x80) LCD_DATA3_PORT |= _BV(LCD_DATA3_PIN); + if(data & 0x40) LCD_DATA2_PORT |= _BV(LCD_DATA2_PIN); + if(data & 0x20) LCD_DATA1_PORT |= _BV(LCD_DATA1_PIN); + if(data & 0x10) LCD_DATA0_PORT |= _BV(LCD_DATA0_PIN); + lcd_e_toggle(); + + /* output low nibble */ + LCD_DATA3_PORT &= ~_BV(LCD_DATA3_PIN); + LCD_DATA2_PORT &= ~_BV(LCD_DATA2_PIN); + LCD_DATA1_PORT &= ~_BV(LCD_DATA1_PIN); + LCD_DATA0_PORT &= ~_BV(LCD_DATA0_PIN); + if(data & 0x08) LCD_DATA3_PORT |= _BV(LCD_DATA3_PIN); + if(data & 0x04) LCD_DATA2_PORT |= _BV(LCD_DATA2_PIN); + if(data & 0x02) LCD_DATA1_PORT |= _BV(LCD_DATA1_PIN); + if(data & 0x01) LCD_DATA0_PORT |= _BV(LCD_DATA0_PIN); + lcd_e_toggle(); + + /* all data pins high (inactive) */ + LCD_DATA0_PORT |= _BV(LCD_DATA0_PIN); + LCD_DATA1_PORT |= _BV(LCD_DATA1_PIN); + LCD_DATA2_PORT |= _BV(LCD_DATA2_PIN); + LCD_DATA3_PORT |= _BV(LCD_DATA3_PIN); + } +} +#else +#define lcd_write(d,rs) if (rs) *(volatile uint8_t*)(LCD_IO_DATA) = d; else *(volatile uint8_t*)(LCD_IO_FUNCTION) = d; +/* rs==0 -> write instruction to LCD_IO_FUNCTION */ +/* rs==1 -> write data to LCD_IO_DATA */ +#endif + + +/************************************************************************* +Low-level function to read byte from LCD controller +Input: rs 1: read data + 0: read busy flag / address counter +Returns: byte read from LCD controller +*************************************************************************/ +#if LCD_IO_MODE +static uint8_t lcd_read(uint8_t rs) +{ + uint8_t data; + + + if (rs) + lcd_rs_high(); /* RS=1: read data */ + else + lcd_rs_low(); /* RS=0: read busy flag */ + lcd_rw_high(); /* RW=1 read mode */ + + if ( ( &LCD_DATA0_PORT == &LCD_DATA1_PORT) && ( &LCD_DATA1_PORT == &LCD_DATA2_PORT ) && ( &LCD_DATA2_PORT == &LCD_DATA3_PORT ) + && ( LCD_DATA0_PIN == 0 )&& (LCD_DATA1_PIN == 1) && (LCD_DATA2_PIN == 2) && (LCD_DATA3_PIN == 3) ) + { + DDR(LCD_DATA0_PORT) &= 0xF0; /* configure data pins as input */ + + lcd_e_high(); + lcd_e_delay(); + data = PIN(LCD_DATA0_PORT) << 4; /* read high nibble first */ + lcd_e_low(); + + lcd_e_delay(); /* Enable 500ns low */ + + lcd_e_high(); + lcd_e_delay(); + data |= PIN(LCD_DATA0_PORT)&0x0F; /* read low nibble */ + lcd_e_low(); + } + else + { + /* configure data pins as input */ + DDR(LCD_DATA0_PORT) &= ~_BV(LCD_DATA0_PIN); + DDR(LCD_DATA1_PORT) &= ~_BV(LCD_DATA1_PIN); + DDR(LCD_DATA2_PORT) &= ~_BV(LCD_DATA2_PIN); + DDR(LCD_DATA3_PORT) &= ~_BV(LCD_DATA3_PIN); + + /* read high nibble first */ + lcd_e_high(); + lcd_e_delay(); + data = 0; + if ( PIN(LCD_DATA0_PORT) & _BV(LCD_DATA0_PIN) ) data |= 0x10; + if ( PIN(LCD_DATA1_PORT) & _BV(LCD_DATA1_PIN) ) data |= 0x20; + if ( PIN(LCD_DATA2_PORT) & _BV(LCD_DATA2_PIN) ) data |= 0x40; + if ( PIN(LCD_DATA3_PORT) & _BV(LCD_DATA3_PIN) ) data |= 0x80; + lcd_e_low(); + + lcd_e_delay(); /* Enable 500ns low */ + + /* read low nibble */ + lcd_e_high(); + lcd_e_delay(); + if ( PIN(LCD_DATA0_PORT) & _BV(LCD_DATA0_PIN) ) data |= 0x01; + if ( PIN(LCD_DATA1_PORT) & _BV(LCD_DATA1_PIN) ) data |= 0x02; + if ( PIN(LCD_DATA2_PORT) & _BV(LCD_DATA2_PIN) ) data |= 0x04; + if ( PIN(LCD_DATA3_PORT) & _BV(LCD_DATA3_PIN) ) data |= 0x08; + lcd_e_low(); + } + return data; +} +#else +#define lcd_read(rs) (rs) ? *(volatile uint8_t*)(LCD_IO_DATA+LCD_IO_READ) : *(volatile uint8_t*)(LCD_IO_FUNCTION+LCD_IO_READ) +/* rs==0 -> read instruction from LCD_IO_FUNCTION */ +/* rs==1 -> read data from LCD_IO_DATA */ +#endif + + +/************************************************************************* +loops while lcd is busy, returns address counter +*************************************************************************/ +static uint8_t lcd_waitbusy(void) + +{ + register uint8_t c; + + /* wait until busy flag is cleared */ + while ( (c=lcd_read(0)) & (1<= LCD_START_LINE2) && (pos < LCD_START_LINE3) ) + addressCounter = LCD_START_LINE3; + else if ( (pos >= LCD_START_LINE3) && (pos < LCD_START_LINE4) ) + addressCounter = LCD_START_LINE4; + else + addressCounter = LCD_START_LINE1; +#else + if ( pos < LCD_START_LINE3 ) + addressCounter = LCD_START_LINE2; + else if ( (pos >= LCD_START_LINE2) && (pos < LCD_START_LINE4) ) + addressCounter = LCD_START_LINE3; + else if ( (pos >= LCD_START_LINE3) && (pos < LCD_START_LINE2) ) + addressCounter = LCD_START_LINE4; + else + addressCounter = LCD_START_LINE1; +#endif +#endif + lcd_command((1<>4; + LCD_DATA0_PORT |= _BV(LCD_DATA0_PIN); // LCD_FUNCTION_8BIT>>4; + lcd_e_toggle(); + delay(LCD_DELAY_INIT); /* delay, busy flag can't be checked here */ + + /* repeat last command */ + lcd_e_toggle(); + delay(LCD_DELAY_INIT_REP); /* delay, busy flag can't be checked here */ + + /* repeat last command a third time */ + lcd_e_toggle(); + delay(LCD_DELAY_INIT_REP); /* delay, busy flag can't be checked here */ + + /* now configure for 4bit mode */ + LCD_DATA0_PORT &= ~_BV(LCD_DATA0_PIN); // LCD_FUNCTION_4BIT_1LINE>>4 + lcd_e_toggle(); + delay(LCD_DELAY_INIT_4BIT); /* some displays need this additional delay */ + + /* from now the LCD only accepts 4 bit I/O, we can use lcd_command() */ +#else + /* + * Initialize LCD to 8 bit memory mapped mode + */ + + /* enable external SRAM (memory mapped lcd) and one wait state */ + MCUCR = _BV(SRE) | _BV(SRW); + + /* reset LCD */ + delay(LCD_DELAY_BOOTUP); /* wait 16ms after power-on */ + lcd_write(LCD_FUNCTION_8BIT_1LINE,0); /* function set: 8bit interface */ + delay(LCD_DELAY_INIT); /* wait 5ms */ + lcd_write(LCD_FUNCTION_8BIT_1LINE,0); /* function set: 8bit interface */ + delay(LCD_DELAY_INIT_REP); /* wait 64us */ + lcd_write(LCD_FUNCTION_8BIT_1LINE,0); /* function set: 8bit interface */ + delay(LCD_DELAY_INIT_REP); /* wait 64us */ +#endif + +#if KS0073_4LINES_MODE + /* Display with KS0073 controller requires special commands for enabling 4 line mode */ + lcd_command(KS0073_EXTENDED_FUNCTION_REGISTER_ON); + lcd_command(KS0073_4LINES_MODE); + lcd_command(KS0073_EXTENDED_FUNCTION_REGISTER_OFF); +#else + lcd_command(LCD_FUNCTION_DEFAULT); /* function set: display lines */ +#endif + lcd_command(LCD_DISP_OFF); /* display off */ + lcd_clrscr(); /* display clear */ + lcd_command(LCD_MODE_DEFAULT); /* set entry mode */ + lcd_command(dispAttr); /* display/cursor control */ + +}/* lcd_init */ diff --git a/lab_3/lcdlibrary/lcd.h b/lab_3/lcdlibrary/lcd.h new file mode 100644 index 0000000..e4df094 --- /dev/null +++ b/lab_3/lcdlibrary/lcd.h @@ -0,0 +1,369 @@ +#ifndef LCD_H +#define LCD_H +/************************************************************************* + Title : C include file for the HD44780U LCD library (lcd.c) + Author: Peter Fleury http://tinyurl.com/peterfleury + File: $Id: lcd.h,v 1.14.2.4 2015/01/20 17:16:07 peter Exp $ + Software: AVR-GCC 4.x + Hardware: any AVR device, memory mapped mode only for AVR with + memory mapped interface (AT90S8515/ATmega8515/ATmega128) +***************************************************************************/ + +/** + @mainpage + Collection of libraries for AVR-GCC + @author Peter Fleury pfleury@gmx.ch http://tinyurl.com/peterfleury + @copyright (C) 2015 Peter Fleury, GNU General Public License Version 3 + + @file + @defgroup pfleury_lcd LCD library + @code #include @endcode + + @brief Basic routines for interfacing a HD44780U-based character LCD display + + LCD character displays can be found in many devices, like espresso machines, laser printers. + The Hitachi HD44780 controller and its compatible controllers like Samsung KS0066U have become an industry standard for these types of displays. + + This library allows easy interfacing with a HD44780 compatible display and can be + operated in memory mapped mode (LCD_IO_MODE defined as 0 in the include file lcd.h.) or in + 4-bit IO port mode (LCD_IO_MODE defined as 1). 8-bit IO port mode is not supported. + + Memory mapped mode is compatible with old Kanda STK200 starter kit, but also supports + generation of R/W signal through A8 address line. + + @see The chapter Interfacing a HD44780 Based LCD to an AVR + on my home page, which shows example circuits how to connect an LCD to an AVR controller. + + @author Peter Fleury pfleury@gmx.ch http://tinyurl.com/peterfleury + + @version 2.0 + + @copyright (C) 2015 Peter Fleury, GNU General Public License Version 3 + +*/ + +#include +#include + +#if (__GNUC__ * 100 + __GNUC_MINOR__) < 405 +#error "This library requires AVR-GCC 4.5 or later, update to newer AVR-GCC compiler !" +#endif + + +/**@{*/ + +/* + * LCD and target specific definitions below can be defined in a separate include file with name lcd_definitions.h instead modifying this file + * by adding -D_LCD_DEFINITIONS_FILE to the CDEFS section in the Makefile + * All definitions added to the file lcd_definitions.h will override the default definitions from lcd.h + */ +#ifdef _LCD_DEFINITIONS_FILE +#include "lcd_definitions.h" +#endif + + +/** + * @name Definition for LCD controller type + * Use 0 for HD44780 controller, change to 1 for displays with KS0073 controller. + */ +#ifndef LCD_CONTROLLER_KS0073 +#define LCD_CONTROLLER_KS0073 0 /**< Use 0 for HD44780 controller, 1 for KS0073 controller */ +#endif + +/** + * @name Definitions for Display Size + * Change these definitions to adapt setting to your display + * + * These definitions can be defined in a separate include file \b lcd_definitions.h instead modifying this file by + * adding -D_LCD_DEFINITIONS_FILE to the CDEFS section in the Makefile. + * All definitions added to the file lcd_definitions.h will override the default definitions from lcd.h + * + */ +#ifndef LCD_LINES +#define LCD_LINES 2 /**< number of visible lines of the display */ +#endif +#ifndef LCD_DISP_LENGTH +#define LCD_DISP_LENGTH 16 /**< visibles characters per line of the display */ +#endif +#ifndef LCD_LINE_LENGTH +#define LCD_LINE_LENGTH 0x40 /**< internal line length of the display */ +#endif +#ifndef LCD_START_LINE1 +#define LCD_START_LINE1 0x00 /**< DDRAM address of first char of line 1 */ +#endif +#ifndef LCD_START_LINE2 +#define LCD_START_LINE2 0x40 /**< DDRAM address of first char of line 2 */ +#endif +#ifndef LCD_START_LINE3 +#define LCD_START_LINE3 0x14 /**< DDRAM address of first char of line 3 */ +#endif +#ifndef LCD_START_LINE4 +#define LCD_START_LINE4 0x54 /**< DDRAM address of first char of line 4 */ +#endif +#ifndef LCD_WRAP_LINES +#define LCD_WRAP_LINES 0 /**< 0: no wrap, 1: wrap at end of visibile line */ +#endif + + +/** + * @name Definitions for 4-bit IO mode + * + * The four LCD data lines and the three control lines RS, RW, E can be on the + * same port or on different ports. + * Change LCD_RS_PORT, LCD_RW_PORT, LCD_E_PORT if you want the control lines on + * different ports. + * + * Normally the four data lines should be mapped to bit 0..3 on one port, but it + * is possible to connect these data lines in different order or even on different + * ports by adapting the LCD_DATAx_PORT and LCD_DATAx_PIN definitions. + * + * Adjust these definitions to your target.\n + * These definitions can be defined in a separate include file \b lcd_definitions.h instead modifying this file by + * adding \b -D_LCD_DEFINITIONS_FILE to the \b CDEFS section in the Makefile. + * All definitions added to the file lcd_definitions.h will override the default definitions from lcd.h + * + */ +#define LCD_IO_MODE 1 /**< 0: memory mapped mode, 1: IO port mode */ + +#if LCD_IO_MODE + +#ifndef LCD_PORT +#define LCD_PORT PORTB /**< port for the LCD lines */ +#endif +#ifndef LCD_DATA0_PORT +#define LCD_DATA0_PORT LCD_PORT /**< port for 4bit data bit 0 */ +#endif +#ifndef LCD_DATA1_PORT +#define LCD_DATA1_PORT LCD_PORT /**< port for 4bit data bit 1 */ +#endif +#ifndef LCD_DATA2_PORT +#define LCD_DATA2_PORT LCD_PORT /**< port for 4bit data bit 2 */ +#endif +#ifndef LCD_DATA3_PORT +#define LCD_DATA3_PORT LCD_PORT /**< port for 4bit data bit 3 */ +#endif +#ifndef LCD_DATA0_PIN +#define LCD_DATA0_PIN 0 /**< pin for 4bit data bit 0 */ +#endif +#ifndef LCD_DATA1_PIN +#define LCD_DATA1_PIN 1 /**< pin for 4bit data bit 1 */ +#endif +#ifndef LCD_DATA2_PIN +#define LCD_DATA2_PIN 2 /**< pin for 4bit data bit 2 */ +#endif +#ifndef LCD_DATA3_PIN +#define LCD_DATA3_PIN 3 /**< pin for 4bit data bit 3 */ +#endif +#ifndef LCD_RS_PORT +#define LCD_RS_PORT LCD_PORT /**< port for RS line */ +#endif +#ifndef LCD_RS_PIN +#define LCD_RS_PIN 4 /**< pin for RS line */ +#endif +#ifndef LCD_RW_PORT +#define LCD_RW_PORT LCD_PORT /**< port for RW line */ +#endif +#ifndef LCD_RW_PIN +#define LCD_RW_PIN 5 /**< pin for RW line */ +#endif +#ifndef LCD_E_PORT +#define LCD_E_PORT LCD_PORT /**< port for Enable line */ +#endif +#ifndef LCD_E_PIN +#define LCD_E_PIN 6 /**< pin for Enable line */ +#endif + +#elif defined(__AVR_AT90S4414__) || defined(__AVR_AT90S8515__) || defined(__AVR_ATmega64__) || \ + defined(__AVR_ATmega8515__)|| defined(__AVR_ATmega103__) || defined(__AVR_ATmega128__) || \ + defined(__AVR_ATmega161__) || defined(__AVR_ATmega162__) +/* + * memory mapped mode is only supported when the device has an external data memory interface + */ +#define LCD_IO_DATA 0xC000 /* A15=E=1, A14=RS=1 */ +#define LCD_IO_FUNCTION 0x8000 /* A15=E=1, A14=RS=0 */ +#define LCD_IO_READ 0x0100 /* A8 =R/W=1 (R/W: 1=Read, 0=Write */ + +#else +#error "external data memory interface not available for this device, use 4-bit IO port mode" + +#endif + + +/** + * @name Definitions of delays + * Used to calculate delay timers. + * Adapt the F_CPU define in the Makefile to the clock frequency in Hz of your target + * + * These delay times can be adjusted, if some displays require different delays.\n + * These definitions can be defined in a separate include file \b lcd_definitions.h instead modifying this file by + * adding \b -D_LCD_DEFINITIONS_FILE to the \b CDEFS section in the Makefile. + * All definitions added to the file lcd_definitions.h will override the default definitions from lcd.h + */ +#ifndef LCD_DELAY_BOOTUP +#define LCD_DELAY_BOOTUP 16000 /**< delay in micro seconds after power-on */ +#endif +#ifndef LCD_DELAY_INIT +#define LCD_DELAY_INIT 5000 /**< delay in micro seconds after initialization command sent */ +#endif +#ifndef LCD_DELAY_INIT_REP +#define LCD_DELAY_INIT_REP 64 /**< delay in micro seconds after initialization command repeated */ +#endif +#ifndef LCD_DELAY_INIT_4BIT +#define LCD_DELAY_INIT_4BIT 64 /**< delay in micro seconds after setting 4-bit mode */ +#endif +#ifndef LCD_DELAY_BUSY_FLAG +#define LCD_DELAY_BUSY_FLAG 4 /**< time in micro seconds the address counter is updated after busy flag is cleared */ +#endif +#ifndef LCD_DELAY_ENABLE_PULSE +#define LCD_DELAY_ENABLE_PULSE 1 /**< enable signal pulse width in micro seconds */ +#endif + + +/** + * @name Definitions for LCD command instructions + * The constants define the various LCD controller instructions which can be passed to the + * function lcd_command(), see HD44780 data sheet for a complete description. + */ + +/* instruction register bit positions, see HD44780U data sheet */ +#define LCD_CLR 0 /* DB0: clear display */ +#define LCD_HOME 1 /* DB1: return to home position */ +#define LCD_ENTRY_MODE 2 /* DB2: set entry mode */ +#define LCD_ENTRY_INC 1 /* DB1: 1=increment, 0=decrement */ +#define LCD_ENTRY_SHIFT 0 /* DB2: 1=display shift on */ +#define LCD_ON 3 /* DB3: turn lcd/cursor on */ +#define LCD_ON_DISPLAY 2 /* DB2: turn display on */ +#define LCD_ON_CURSOR 1 /* DB1: turn cursor on */ +#define LCD_ON_BLINK 0 /* DB0: blinking cursor ? */ +#define LCD_MOVE 4 /* DB4: move cursor/display */ +#define LCD_MOVE_DISP 3 /* DB3: move display (0-> cursor) ? */ +#define LCD_MOVE_RIGHT 2 /* DB2: move right (0-> left) ? */ +#define LCD_FUNCTION 5 /* DB5: function set */ +#define LCD_FUNCTION_8BIT 4 /* DB4: set 8BIT mode (0->4BIT mode) */ +#define LCD_FUNCTION_2LINES 3 /* DB3: two lines (0->one line) */ +#define LCD_FUNCTION_10DOTS 2 /* DB2: 5x10 font (0->5x7 font) */ +#define LCD_CGRAM 6 /* DB6: set CG RAM address */ +#define LCD_DDRAM 7 /* DB7: set DD RAM address */ +#define LCD_BUSY 7 /* DB7: LCD is busy */ + +/* set entry mode: display shift on/off, dec/inc cursor move direction */ +#define LCD_ENTRY_DEC 0x04 /* display shift off, dec cursor move dir */ +#define LCD_ENTRY_DEC_SHIFT 0x05 /* display shift on, dec cursor move dir */ +#define LCD_ENTRY_INC_ 0x06 /* display shift off, inc cursor move dir */ +#define LCD_ENTRY_INC_SHIFT 0x07 /* display shift on, inc cursor move dir */ + +/* display on/off, cursor on/off, blinking char at cursor position */ +#define LCD_DISP_OFF 0x08 /* display off */ +#define LCD_DISP_ON 0x0C /* display on, cursor off */ +#define LCD_DISP_ON_BLINK 0x0D /* display on, cursor off, blink char */ +#define LCD_DISP_ON_CURSOR 0x0E /* display on, cursor on */ +#define LCD_DISP_ON_CURSOR_BLINK 0x0F /* display on, cursor on, blink char */ + +/* move cursor/shift display */ +#define LCD_MOVE_CURSOR_LEFT 0x10 /* move cursor left (decrement) */ +#define LCD_MOVE_CURSOR_RIGHT 0x14 /* move cursor right (increment) */ +#define LCD_MOVE_DISP_LEFT 0x18 /* shift display left */ +#define LCD_MOVE_DISP_RIGHT 0x1C /* shift display right */ + +/* function set: set interface data length and number of display lines */ +#define LCD_FUNCTION_4BIT_1LINE 0x20 /* 4-bit interface, single line, 5x7 dots */ +#define LCD_FUNCTION_4BIT_2LINES 0x28 /* 4-bit interface, dual line, 5x7 dots */ +#define LCD_FUNCTION_8BIT_1LINE 0x30 /* 8-bit interface, single line, 5x7 dots */ +#define LCD_FUNCTION_8BIT_2LINES 0x38 /* 8-bit interface, dual line, 5x7 dots */ + + +#define LCD_MODE_DEFAULT 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 j`fq%uf1{8z|37w + + + + + +AVR-GCC Libraries: LCD library <lcd.h> + + + + + + +

+
+ + + + + + +
+
AVR-GCC Libraries +
+
+
+ + + +
+
+
+
LCD library <lcd.h>
+
+
+

Detailed Description

+

Basic routines for interfacing a HD44780U-based character LCD display.

+
#include <lcd.h>
+

LCD character displays can be found in many devices, like espresso machines, laser printers. The Hitachi HD44780 controller and its compatible controllers like Samsung KS0066U have become an industry standard for these types of displays.

+

This library allows easy interfacing with a HD44780 compatible display and can be operated in memory mapped mode (LCD_IO_MODE defined as 0 in the include file lcd.h.) or in 4-bit IO port mode (LCD_IO_MODE defined as 1). 8-bit IO port mode is not supported.

+

Memory mapped mode is compatible with old Kanda STK200 starter kit, but also supports generation of R/W signal through A8 address line.

+
See also
The chapter Interfacing a HD44780 Based LCD to an AVR on my home page, which shows example circuits how to connect an LCD to an AVR controller.
+
Author
Peter Fleury pfleu.nosp@m.ry@g.nosp@m.mx.ch http://tinyurl.com/peterfleury
+
Version
2.0
+
Copyright
(C) 2015 Peter Fleury, GNU General Public License Version 3
+ + + + + +

+Definition for LCD controller type

Use 0 for HD44780 controller, change to 1 for displays with KS0073 controller.

+
#define LCD_CONTROLLER_KS0073   0
 
+ + + + + + + + + + + + + + + + + + +

+Definitions for Display Size

Change these definitions to adapt setting to your display

+

These definitions can be defined in a separate include file lcd_definitions.h instead modifying this file by adding -D_LCD_DEFINITIONS_FILE to the CDEFS section in the Makefile. All definitions added to the file lcd_definitions.h will override the default definitions from lcd.h

+
#define LCD_LINES   2
 
#define LCD_DISP_LENGTH   16
 
#define LCD_LINE_LENGTH   0x40
 
#define LCD_START_LINE1   0x00
 
#define LCD_START_LINE2   0x40
 
#define LCD_START_LINE3   0x14
 
#define LCD_START_LINE4   0x54
 
#define LCD_WRAP_LINES   0
 
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Definitions for 4-bit IO mode

The four LCD data lines and the three control lines RS, RW, E can be on the same port or on different ports. Change LCD_RS_PORT, LCD_RW_PORT, LCD_E_PORT if you want the control lines on different ports.

+

Normally the four data lines should be mapped to bit 0..3 on one port, but it is possible to connect these data lines in different order or even on different ports by adapting the LCD_DATAx_PORT and LCD_DATAx_PIN definitions.

+

Adjust these definitions to your target.
+ These definitions can be defined in a separate include file lcd_definitions.h instead modifying this file by adding -D_LCD_DEFINITIONS_FILE to the CDEFS section in the Makefile. All definitions added to the file lcd_definitions.h will override the default definitions from lcd.h

+
#define LCD_IO_MODE   1
 
#define LCD_PORT   PORTA
 
#define LCD_DATA0_PORT   LCD_PORT
 
#define LCD_DATA1_PORT   LCD_PORT
 
#define LCD_DATA2_PORT   LCD_PORT
 
#define LCD_DATA3_PORT   LCD_PORT
 
#define LCD_DATA0_PIN   0
 
#define LCD_DATA1_PIN   1
 
#define LCD_DATA2_PIN   2
 
#define LCD_DATA3_PIN   3
 
#define LCD_RS_PORT   LCD_PORT
 
#define LCD_RS_PIN   4
 
#define LCD_RW_PORT   LCD_PORT
 
#define LCD_RW_PIN   5
 
#define LCD_E_PORT   LCD_PORT
 
#define LCD_E_PIN   6
 
+ + + + + + + + + + + + + + +

+Definitions of delays

Used to calculate delay timers. Adapt the F_CPU define in the Makefile to the clock frequency in Hz of your target

+

These delay times can be adjusted, if some displays require different delays.
+ These definitions can be defined in a separate include file lcd_definitions.h instead modifying this file by adding -D_LCD_DEFINITIONS_FILE to the CDEFS section in the Makefile. All definitions added to the file lcd_definitions.h will override the default definitions from lcd.h

+
#define LCD_DELAY_BOOTUP   16000
 
#define LCD_DELAY_INIT   5000
 
#define LCD_DELAY_INIT_REP   64
 
#define LCD_DELAY_INIT_4BIT   64
 
#define LCD_DELAY_BUSY_FLAG   4
 
#define LCD_DELAY_ENABLE_PULSE   1
 
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Definitions for LCD command instructions

The constants define the various LCD controller instructions which can be passed to the function lcd_command(), see HD44780 data sheet for a complete description.

+
+#define LCD_CLR   0 /* DB0: clear display */
 
+#define LCD_HOME   1 /* DB1: return to home position */
 
+#define LCD_ENTRY_MODE   2 /* DB2: set entry mode */
 
+#define LCD_ENTRY_INC   1 /* DB1: 1=increment, 0=decrement */
 
+#define LCD_ENTRY_SHIFT   0 /* DB2: 1=display shift on */
 
+#define LCD_ON   3 /* DB3: turn lcd/cursor on */
 
+#define LCD_ON_DISPLAY   2 /* DB2: turn display on */
 
+#define LCD_ON_CURSOR   1 /* DB1: turn cursor on */
 
+#define LCD_ON_BLINK   0 /* DB0: blinking cursor ? */
 
+#define LCD_MOVE   4 /* DB4: move cursor/display */
 
+#define LCD_MOVE_DISP   3 /* DB3: move display (0-> cursor) ? */
 
+#define LCD_MOVE_RIGHT   2 /* DB2: move right (0-> left) ? */
 
+#define LCD_FUNCTION   5 /* DB5: function set */
 
+#define LCD_FUNCTION_8BIT   4 /* DB4: set 8BIT mode (0->4BIT mode) */
 
+#define LCD_FUNCTION_2LINES   3 /* DB3: two lines (0->one line) */
 
+#define LCD_FUNCTION_10DOTS   2 /* DB2: 5x10 font (0->5x7 font) */
 
+#define LCD_CGRAM   6 /* DB6: set CG RAM address */
 
+#define LCD_DDRAM   7 /* DB7: set DD RAM address */
 
+#define LCD_BUSY   7 /* DB7: LCD is busy */
 
+#define LCD_ENTRY_DEC   0x04 /* display shift off, dec cursor move dir */
 
+#define LCD_ENTRY_DEC_SHIFT   0x05 /* display shift on, dec cursor move dir */
 
+#define LCD_ENTRY_INC_   0x06 /* display shift off, inc cursor move dir */
 
+#define LCD_ENTRY_INC_SHIFT   0x07 /* display shift on, inc cursor move dir */
 
+#define LCD_DISP_OFF   0x08 /* display off */
 
+#define LCD_DISP_ON   0x0C /* display on, cursor off */
 
+#define LCD_DISP_ON_BLINK   0x0D /* display on, cursor off, blink char */
 
+#define LCD_DISP_ON_CURSOR   0x0E /* display on, cursor on */
 
+#define LCD_DISP_ON_CURSOR_BLINK   0x0F /* display on, cursor on, blink char */
 
+#define LCD_MOVE_CURSOR_LEFT   0x10 /* move cursor left (decrement) */
 
+#define LCD_MOVE_CURSOR_RIGHT   0x14 /* move cursor right (increment) */
 
+#define LCD_MOVE_DISP_LEFT   0x18 /* shift display left */
 
+#define LCD_MOVE_DISP_RIGHT   0x1C /* shift display right */
 
+#define LCD_FUNCTION_4BIT_1LINE   0x20 /* 4-bit interface, single line, 5x7 dots */
 
+#define LCD_FUNCTION_4BIT_2LINES   0x28 /* 4-bit interface, dual line, 5x7 dots */
 
+#define LCD_FUNCTION_8BIT_1LINE   0x30 /* 8-bit interface, single line, 5x7 dots */
 
+#define LCD_FUNCTION_8BIT_2LINES   0x38 /* 8-bit interface, dual line, 5x7 dots */
 
+#define LCD_MODE_DEFAULT   ((1<<LCD_ENTRY_MODE) | (1<<LCD_ENTRY_INC) )
 
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+Functions

void lcd_init (uint8_t dispAttr)
 Initialize display and select type of cursor. More...
 
void lcd_clrscr (void)
 Clear display and set cursor to home position. More...
 
void lcd_home (void)
 Set cursor to home position. More...
 
void lcd_gotoxy (uint8_t x, uint8_t y)
 Set cursor to specified position. More...
 
void lcd_putc (char c)
 Display character at current cursor position. More...
 
void lcd_puts (const char *s)
 Display string without auto linefeed. More...
 
void lcd_puts_p (const char *progmem_s)
 Display string from program memory without auto linefeed. More...
 
void lcd_command (uint8_t cmd)
 Send LCD controller instruction command. More...
 
void lcd_data (uint8_t data)
 Send data byte to LCD controller. More...
 
+#define lcd_puts_P(__s)   lcd_puts_p(PSTR(__s))
 macros for automatically storing string constant in program memory
 
+

Macro Definition Documentation

+ +
+
+ + + + +
#define LCD_CONTROLLER_KS0073   0
+
+

Use 0 for HD44780 controller, 1 for KS0073 controller

+ +
+
+ +
+
+ + + + +
#define LCD_LINES   2
+
+

number of visible lines of the display

+ +
+
+ +
+
+ + + + +
#define LCD_DISP_LENGTH   16
+
+

visibles characters per line of the display

+ +
+
+ +
+
+ + + + +
#define LCD_LINE_LENGTH   0x40
+
+

internal line length of the display

+ +
+
+ +
+
+ + + + +
#define LCD_START_LINE1   0x00
+
+

DDRAM address of first char of line 1

+ +
+
+ +
+
+ + + + +
#define LCD_START_LINE2   0x40
+
+

DDRAM address of first char of line 2

+ +
+
+ +
+
+ + + + +
#define LCD_START_LINE3   0x14
+
+

DDRAM address of first char of line 3

+ +
+
+ +
+
+ + + + +
#define LCD_START_LINE4   0x54
+
+

DDRAM address of first char of line 4

+ +
+
+ +
+
+ + + + +
#define LCD_WRAP_LINES   0
+
+

0: no wrap, 1: wrap at end of visibile line

+ +
+
+ +
+
+ + + + +
#define LCD_IO_MODE   1
+
+

0: memory mapped mode, 1: IO port mode

+ +
+
+ +
+
+ + + + +
#define LCD_PORT   PORTA
+
+

port for the LCD lines

+ +
+
+ +
+
+ + + + +
#define LCD_DATA0_PORT   LCD_PORT
+
+

port for 4bit data bit 0

+ +
+
+ +
+
+ + + + +
#define LCD_DATA1_PORT   LCD_PORT
+
+

port for 4bit data bit 1

+ +
+
+ +
+
+ + + + +
#define LCD_DATA2_PORT   LCD_PORT
+
+

port for 4bit data bit 2

+ +
+
+ +
+
+ + + + +
#define LCD_DATA3_PORT   LCD_PORT
+
+

port for 4bit data bit 3

+ +
+
+ +
+
+ + + + +
#define LCD_DATA0_PIN   0
+
+

pin for 4bit data bit 0

+ +
+
+ +
+
+ + + + +
#define LCD_DATA1_PIN   1
+
+

pin for 4bit data bit 1

+ +
+
+ +
+
+ + + + +
#define LCD_DATA2_PIN   2
+
+

pin for 4bit data bit 2

+ +
+
+ +
+
+ + + + +
#define LCD_DATA3_PIN   3
+
+

pin for 4bit data bit 3

+ +
+
+ +
+
+ + + + +
#define LCD_RS_PORT   LCD_PORT
+
+

port for RS line

+ +
+
+ +
+
+ + + + +
#define LCD_RS_PIN   4
+
+

pin for RS line

+ +
+
+ +
+
+ + + + +
#define LCD_RW_PORT   LCD_PORT
+
+

port for RW line

+ +
+
+ +
+
+ + + + +
#define LCD_RW_PIN   5
+
+

pin for RW line

+ +
+
+ +
+
+ + + + +
#define LCD_E_PORT   LCD_PORT
+
+

port for Enable line

+ +
+
+ +
+
+ + + + +
#define LCD_E_PIN   6
+
+

pin for Enable line

+ +
+
+ +
+
+ + + + +
#define LCD_DELAY_BOOTUP   16000
+
+

delay in micro seconds after power-on

+ +
+
+ +
+
+ + + + +
#define LCD_DELAY_INIT   5000
+
+

delay in micro seconds after initialization command sent

+ +
+
+ +
+
+ + + + +
#define LCD_DELAY_INIT_REP   64
+
+

delay in micro seconds after initialization command repeated

+ +
+
+ +
+
+ + + + +
#define LCD_DELAY_INIT_4BIT   64
+
+

delay in micro seconds after setting 4-bit mode

+ +
+
+ +
+
+ + + + +
#define LCD_DELAY_BUSY_FLAG   4
+
+

time in micro seconds the address counter is updated after busy flag is cleared

+ +
+
+ +
+
+ + + + +
#define LCD_DELAY_ENABLE_PULSE   1
+
+

enable signal pulse width in micro seconds

+ +
+
+

Function Documentation

+ +
+
+ + + + + + + + +
void lcd_init (uint8_t dispAttr)
+
+ +

Initialize display and select type of cursor.

+
Parameters
+ + +
dispAttrLCD_DISP_OFF display off
+ LCD_DISP_ON display on, cursor off
+ LCD_DISP_ON_CURSOR display on, cursor on
+ LCD_DISP_ON_CURSOR_BLINK display on, cursor on flashing
+
+
+
Returns
none
+ +
+
+ +
+
+ + + + + + + + +
void lcd_clrscr (void )
+
+ +

Clear display and set cursor to home position.

+
Returns
none
+ +
+
+ +
+
+ + + + + + + + +
void lcd_home (void )
+
+ +

Set cursor to home position.

+
Returns
none
+ +
+
+ +
+
+ + + + + + + + + + + + + + + + + + +
void lcd_gotoxy (uint8_t x,
uint8_t y 
)
+
+ +

Set cursor to specified position.

+
Parameters
+ + + +
xhorizontal position
+ (0: left most position)
yvertical position
+ (0: first line)
+
+
+
Returns
none
+ +
+
+ +
+
+ + + + + + + + +
void lcd_putc (char c)
+
+ +

Display character at current cursor position.

+
Parameters
+ + +
ccharacter to be displayed
+
+
+
Returns
none
+ +
+
+ +
+
+ + + + + + + + +
void lcd_puts (const char * s)
+
+ +

Display string without auto linefeed.

+
Parameters
+ + +
sstring to be displayed
+
+
+
Returns
none
+ +
+
+ +
+
+ + + + + + + + +
void lcd_puts_p (const char * progmem_s)
+
+ +

Display string from program memory without auto linefeed.

+
Parameters
+ + +
progmem_sstring from program memory be be displayed
+
+
+
Returns
none
+
See also
lcd_puts_P
+ +
+
+ +
+
+ + + + + + + + +
void lcd_command (uint8_t cmd)
+
+ +

Send LCD controller instruction command.

+
Parameters
+ + +
cmdinstruction to send to LCD controller, see HD44780 data sheet
+
+
+
Returns
none
+ +
+
+ +
+
+ + + + + + + + +
void lcd_data (uint8_t data)
+
+ +

Send data byte to LCD controller.

+

Similar to lcd_putc(), but without interpreting LF

Parameters
+ + +
databyte to send to LCD controller, see HD44780 data sheet
+
+
+
Returns
none
+ +
+
+
+ +
+Generated on Sat Jan 31 2015 21:02:51 for AVR-GCC Libraries by   +doxygen + 1.8.9.1 +
+ + diff --git a/lab_3/lcdlibrary/test_lcd.c b/lab_3/lcdlibrary/test_lcd.c new file mode 100644 index 0000000..2ddcb6b --- /dev/null +++ b/lab_3/lcdlibrary/test_lcd.c @@ -0,0 +1,167 @@ +/************************************************************************* +Title: Testing output to a HD44780 based LCD display. +Author: Peter Fleury http://tinyurl.com/peterfleury +File: $Id: test_lcd.c,v 1.8 2015/01/31 18:04:08 peter Exp $ +Software: AVR-GCC 4.x +Hardware: HD44780 compatible LCD text display + AVR with external SRAM interface if memory-mapped LCD interface is used + any AVR with 7 free I/O pins if 4-bit IO port mode is used +**************************************************************************/ +#include +#include +#include +#include +#include "lcd.h" + + +/* +** constant definitions +*/ +static const PROGMEM unsigned char copyRightChar[] = +{ + 0x07, 0x08, 0x13, 0x14, 0x14, 0x13, 0x08, 0x07, + 0x00, 0x10, 0x08, 0x08, 0x08, 0x08, 0x10, 0x00 +}; + + +/* +** function prototypes +*/ +void wait_until_key_pressed(void); + + +void wait_until_key_pressed(void) +{ + unsigned char temp1, temp2; + + do { + temp1 = PIND; // read input + _delay_ms(5); // delay for key debounce + temp2 = PIND; // read input + temp1 = (temp1 & temp2); // debounce input + } while ( temp1 & _BV(PIND2) ); + + loop_until_bit_is_set(PIND,PIND2); /* wait until key is released */ +} + + +int main(void) +{ + char buffer[7]; + int num=134; + unsigned char i; + + + DDRD &=~ (1 << PD2); /* Pin PD2 input */ + PORTD |= (1 << PD2); /* Pin PD2 pull-up enabled */ + + + /* initialize display, cursor off */ + lcd_init(LCD_DISP_ON); + + for (;;) { /* loop forever */ + /* + * Test 1: write text to display + */ + + /* clear display and home cursor */ + lcd_clrscr(); + + /* put string to display (line 1) with linefeed */ + lcd_puts("LCD Test Line 1\n"); + + /* cursor is now on second line, write second line */ + lcd_puts("Line 2"); + + /* move cursor to position 8 on line 2 */ + lcd_gotoxy(7,1); + + /* write single char to display */ + lcd_putc(':'); + + /* wait until push button PD2 (INT0) is pressed */ + wait_until_key_pressed(); + + + /* + * Test 2: use lcd_command() to turn on cursor + */ + + /* turn on cursor */ + lcd_command(LCD_DISP_ON_CURSOR); + + /* put string */ + lcd_puts( "CurOn"); + + /* wait until push button PD2 (INT0) is pressed */ + wait_until_key_pressed(); + + + /* + * Test 3: display shift + */ + + lcd_clrscr(); /* clear display home cursor */ + + /* put string from program memory to display */ + lcd_puts_P( "Line 1 longer than 14 characters\n" ); + lcd_puts_P( "Line 2 longer than 14 characters" ); + + /* move BOTH lines one position to the left */ + lcd_command(LCD_MOVE_DISP_LEFT); + + /* wait until push button PD2 (INT0) is pressed */ + wait_until_key_pressed(); + + /* turn off cursor */ + lcd_command(LCD_DISP_ON); + + + /* + * Test: Display integer values + */ + + lcd_clrscr(); /* clear display home cursor */ + + /* convert interger into string */ + itoa( num , buffer, 10); + + /* put converted string to display */ + lcd_puts(buffer); + + /* wait until push button PD2 (INT0) is pressed */ + wait_until_key_pressed(); + + + /* + * Test: Display userdefined characters + */ + + lcd_clrscr(); /* clear display home cursor */ + + lcd_puts("Copyright: "); + + /* + * load two userdefined characters from program memory + * into LCD controller CG RAM location 0 and 1 + */ + lcd_command(_BV(LCD_CGRAM)); /* set CG RAM start address 0 */ + for(i=0; i<16; i++) + { + lcd_data(pgm_read_byte_near(©RightChar[i])); + } + + /* move cursor to position 0 on line 2 */ + /* Note: this switched back to DD RAM adresses */ + lcd_gotoxy(0,1); + + /* display user defined (c), built using two user defined chars */ + lcd_putc(0); + lcd_putc(1); + + + /* wait until push button PD2 (INT0) is pressed */ + wait_until_key_pressed(); + + } +} diff --git a/lab_3/main.c b/lab_3/main.c index fb3e1e6..af7c537 100755 --- a/lab_3/main.c +++ b/lab_3/main.c @@ -1,13 +1,72 @@ #include -// Set up GPIO here -void pin_setup() { +#include "main.h" +#include "lcdlibrary/lcd.h" +/** @brief Initialises general pins for use. + * + * @note Does not initialise LCD pins. That is handled by lcdlibrary + */ +void pin_init() { + /* Pin Mappings: + * PC0 -> ADC0 input for diode measurement + * PC1 -> ADC1 input for LM35 + */ + + // Pin Config for Diode ADC + DDRC &= ~(1 << DDRC0); + DIDR0 |= (1 << ADC0D); // Disable digital input + + // Pin Config for LM35 ADC + DDRC &= ~(1 << DDRC1); + DIDR0 |= (1 << ADC1D); // Disable digital input +} + +/** @brief Initializes ADC with required settings + */ +void adc_init() { + /* ADC Settings + * Use Aref as Vref + * Initially set input as GND + * Data right-adjusted + * No Interrupts + */ + + // Set MUX[3:0] to 0b1111 (GND reference) + ADMUX |= (1 << MUX3) | (1 << MUX2) | (1 << MUX1) | (1 << MUX0); + // Make sure data is right adjusted + ADMUX &= ~(1 << ADLAR); + + // Set the clock prescaler to 128 (slower ADC means more accurate measurements) + ADCSRA |= (1 << ADPS2) | (1 << ADPS1) (1 << ADPS0); + // Enable ADC + ADCSRA |= (1 << ADEN); +} + +/** @brief Blocking function to read an ADC conversion from a selected ADC input. + * + * @note Blocks until conversion finishes, so speed of this function is dependant + * on ADC prescaler. + */ +uint16_t adc_run_conversion(uint8_t adc_selection) { + // Select ADC + ADMUX &= 0xF0 | adc_selection; + + // Start conversion + ADCSRA |= (1 << ADSC); + + // Wait until conversion is complete + while (ADCSRA & (1 << ADIF)); + + // Read out conversion value + // may not be correct + return ADC; } int main() { - pin_setup() + pin_init(); + adc_init(); while (1) { diff --git a/lab_3/main.h b/lab_3/main.h new file mode 100644 index 0000000..5655cab --- /dev/null +++ b/lab_3/main.h @@ -0,0 +1,5 @@ +#ifndef MAIN_H_ +#define MAIN_H_ + + +#endif \ No newline at end of file