Hackatronics Arduino Multi Function Shield

Hackatronics Using an Arduino Multi-function Multi-function Shield

By Kashif Baig © 2015 cohesivecomputing.co.uk

Hackatronics – Using an Aruino !u"ti#function $hie"

cohesivecomputing.co.uk

%ntroucing Hackatronics – &oing for 'un..................................... 'un............................................................ .............................................. .........................( ..( %nsta""ing the mu"ti#function shie" "i)rary........................... "i)rary.................................................. .............................................. .................................( ..........( !ore a)out this series................................................ series....................................................................... .............................................. ............................................( .....................( *art 1 Basic %nput + ,utput......................................... ,utput................................................................ .............................................. ...............................................5 ........................5 Using the shie"-s )eeper............................................... )eeper...................................................................... ...................................................... ............................... ........5 etecting )utton presses on the shie".................................................... shie"......................................................................................... ..................................... 5 /riting to the shie"-s igit isp"ay................................................. isp"ay............................................................................................. ............................................ &ontro""ing the shie"-s  "ights.................................................................. "ights......................................................................................... ............................3 .....3 4eaing the va"ue of the shie"-s potentiometer..........................................................................3 *art 2 4eaing $ensors............................................ $ensors................................................................... .............................................. .................................................. ........................... &ounting pu"ses............................................. pu"ses.................................................................... .............................................. ........................................................ ................................. 4eaing the temperature using an !(5 sensor...................................................... sensor........................................................................ .................. 10 Using an a n H& $406 sonar mou"e...................................... mou"e............................................................. .............................................. ..................................10 ...........10 7etting ata from an !*U050 motion sensor..................... s ensor............................................ .............................................. ..............................11 .......11 *art ( 4ea" /or" App"ications.................. App"ications......................................... .............................................. .............................................. ......................................16 ...............16 &ounto8n timer................................................ timer....................................................................... .............................................. .................................................16 ..........................16 26 Hour A"arm &"ock......................................... &"ock................................................................ .............................................. .................................................15 ..........................15 Heart monitor.......................................... monitor................................................................. .............................................. ................................................... ............................ .........1 ......... 1 $urface inc"ine inicator........................................... inicator.................................................................. .............................................. ...........................................21 ....................21 $onar ranger............................................ ranger................................................................... .............................................. ................................................... ............................ .........2( ......... 2( $peeometer........................................... $peeometer................... ............................................... .............................................. .............................................................26 ......................................26 Appenices......................................... Appenices.................. .............................................. .............................................. .............................................. ............................................ .......................23 ..23 !u"ti#function $hie" i)rary He"p.......................................................... He"p............................................................................... ................................. ............23 23 !*U050 He"p.............................................. He"p..................................................................... .............................................. .............................................. ...............................(0 ........(0



%ntroucing Hackatronics – &oing for 'un..................................... 'un............................................................ .............................................. .........................( ..( %nsta""ing the mu"ti#function shie" "i)rary........................... "i)rary.................................................. .............................................. .................................( ..........( !ore a)out this series................................................ series....................................................................... .............................................. ............................................( .....................( *art 1 Basic %nput + ,utput......................................... ,utput................................................................ .............................................. ...............................................5 ........................5 Using the shie"-s )eeper............................................... )eeper...................................................................... ...................................................... ............................... ........5 etecting )utton presses on the shie".................................................... shie"......................................................................................... ..................................... 5 /riting to the shie"-s igit isp"ay................................................. isp"ay............................................................................................. ............................................ &ontro""ing the shie"-s  "ights.................................................................. "ights......................................................................................... ............................3 .....3 4eaing the va"ue of the shie"-s potentiometer..........................................................................3 *art 2 4eaing $ensors............................................ $ensors................................................................... .............................................. .................................................. ........................... &ounting pu"ses............................................. pu"ses.................................................................... .............................................. ........................................................ ................................. 4eaing the temperature using an !(5 sensor...................................................... sensor........................................................................ .................. 10 Using an a n H& $406 sonar mou"e...................................... mou"e............................................................. .............................................. ..................................10 ...........10 7etting ata from an !*U050 motion sensor..................... s ensor............................................ .............................................. ..............................11 .......11 *art ( 4ea" /or" App"ications.................. App"ications......................................... .............................................. .............................................. ......................................16 ...............16 &ounto8n timer................................................ timer....................................................................... .............................................. .................................................16 ..........................16 26 Hour A"arm &"ock......................................... &"ock................................................................ .............................................. .................................................15 ..........................15 Heart monitor.......................................... monitor................................................................. .............................................. ................................................... ............................ .........1 ......... 1 $urface inc"ine inicator........................................... inicator.................................................................. .............................................. ...........................................21 ....................21 $onar ranger............................................ ranger................................................................... .............................................. ................................................... ............................ .........2( ......... 2( $peeometer........................................... $peeometer................... ............................................... .............................................. .............................................................26 ......................................26 Appenices......................................... Appenices.................. .............................................. .............................................. .............................................. ............................................ .......................23 ..23 !u"ti#function $hie" i)rary He"p.......................................................... He"p............................................................................... ................................. ............23 23 !*U050 He"p.............................................. He"p..................................................................... .............................................. .............................................. ...............................(0 ........(0



Introducing Hackatronics – Coding for Fun /hen % 8as a)out 10 years o" my fo"ks )ought me a &6 computer9 an very soon % 8as "earning ho8 to connect some )asic components an sensors to its :oystick an para""e" ports to try an o some interesting things. ;his 8as 8ay )ack in 1<(. ,n one occasion9 % actua""y manage to fry this =(50 computer 8hi"e so"ering a 8ire that 8as connecte to a port 8hen it 8as s8itche on. 'ortunate"y9 % got the &6 repaire at minima" cost9 )ut on-t try something "ike that yourse"f. ;oay9 the 4asp)erry *i an Aruino range of microcontro""ers is a great 8ay to start to "earn ho8 to 8rite coe that connects 8ith the outsie 8or". %n aition9 there are numerous e"ectronic a# ons 8ith components a"reay )ui"t on to them9 them9 reay to )e uti"i>e 8ith a )it of coe. ,ne such a#on is a mu"ti#function Aruino shie" avai"a)"e at "o8 cost from internet supp"iers9 one such )eing Ho))y &omponents? &omponents ? $imp"e %+, that is usua""y taken for grante on *&s9 "ike reaing key presses9 outputting to a isp"ay9 an souning an a"arm9 often get in the 8ay of the focus of the main task 8hen eve"oping for microcontro""ers. %t is for this reason % have eve"ope a "i)rary for this mu"ti#function shie" that simp"ifies )asic an munane %+, operations. % a"so provie a set of rea" 8or" app"ications that make use of this "i)rary as part of a coing series9 so those ne8 to coing on the Aruino can e@periment 8ith an enhance them. /e""9 that-s ho8 % "earnt ho8 to coe a"" those years ago. $ome fami"iarity 8ith the Aruino p"atform is assume9 as is the insta""ation of the Aruino eve"opment environment. environment . A emo vieo of some of the Aruino app"ications is avai"a)"e from my 8e)site.

Installing the multi-function shield library %f you haven-t a"reay one so9 you 8i"" nee to first insta"" the ;imer,ne an $oft8are %2& "i)raries using instructions for insta""ing Aruino "i)raries. "i)raries . ou can o8n"oa the mu"ti#function shie" "i)rary from the "ink )e"o8 an insta"" as a .>ip "i)rary9 referring to the instructions in the "ink a)ove?  

!u"ti#function $hie" i)rary A"" source coe use in series

%f for any reason you haven-t )een successfu" insta""ing any of the "i)raries9 then o8n"oa this "i)rary )un"e instea9 )un"e instea9 un>ip an copy to your ocumentsAruino"i)raries fo"er Cif using /ino8sD or ,$ eEuiva"ent. A"though 8e o everything to ensure our o8n"oas are free from viruses an ma"8are9 p"ease check that your virus an ma"8are scanning soft8are is up to ate )efore han. % must point out that )y fo""o8ing the Hackatronics series9 you agree to o so at your o8n risk9 an agree to take fu"" responsi)i"ity for any "oss or amages you may incur upon yourse"f or others. %f you-re a ki starting out9 )e sure to have supervision of a responsi)"e au"t.

More about this series ;his series is ivie in to three main parts? 1. Basi Basicc %npu %nputt + ,ut ,utpu putt

*age ( of (0



2. 4eaing $ensors (. 4ea" /or" App"ications *art 1 emonstrates the ease 8ith 8hich the mu"ti#function shie" )uttons9 )eeper an isp"ay can uti"i>e )y using the shie" "i)rary9 conseEuent"y making it easier to concentrate on the "ogic of the app"ication. *art 2 emonstrates ho8 the shie" "i)rary can )e use to rea va"ues from e@terna" sensors9 such as temperature9 sonar an motion sensors9 an ho8 to process e"ectronic pu"ses from an e@terna" source. *art ( e@p"ores 8orking app"ications using the "i)rary an the mu"ti#function shie"?      

26 hour a"arm c"ock Heart monitor – CreEuires heart pu"se sensorD &ount o8n timer $urface inc"ine "eve" inicator– CreEuires !*U050 motion sensorD $onar ranger – CreEuires H& $406 sonar mou"eD $peeometer – CreEuires magnet an ree s8itchD

ach of these has scope to )e )ui"t upon an e@pane9 )ut % "eave that to you. 7et coing an have funF

*age 6 of (0



Part 1 Basic Input / Output ;his is part one of the App"ie Hackatronics $eries for the Aruino !u"ti#function shie"9 8hich sho8s ho8 to use the shie" "i)rary to access the mu"ti#function shie" )uttons9 )u>>er an isp"ay. %f you haven-t a"reay one so9 you-"" nee to o8n"oa the source coe an insta"" the "i)raries using the "inks in the introuction. By fo""o8ing the Hackatronics series9 you agree to o so at your o8n risk9 an agree to take fu"" responsi)i"ity for any "oss or amages you may incur upon yourse"f or others.

Using the shield’s beeper ;he mu"ti#function shie" "i)rary provies a f"e@i)"e 8ay to soun ifferent types of a"arms using the )eeper. ;he actua" timing an souning of the )eeper is contro""e in the )ackgroun using interrupts9 8hich means your app"ication can continue to focus on performing its main task. #include #include #include void setup() { // put your setup code here to run once! Timer".initili$e()% MFS.initili$e(&Timer")%

// initili$e multi'unction shield lirry

// *OT+ eep control is perormed in the c,-round i.e. eep() is non loc,in-. // short eep or  milliseconds MFS.eep()% dely(")% // 0 short eeps MFS.eep(2 // 2 // 0 // 1 // 2 // )%

repeted 1 times. eep or 2 milliseconds silent or 2 milliseconds repet ove cycle 0 times loop 1 times 3it 2 milliseconds et3een loop

4 void loop() { // put your min code here to run repetedly! 4

Detecting button presses on the shield /ith the mu"ti#function shie" "i)rary9 ifferent types of )utton presses can )e etecte? short press9 "ong press9 )utton re"ease after short press9 )utton re"ease after "ong press. ;he sketch )e"o8 isp"ays the type of )utton press in the seria" monitor 8ino8. &heck 8hat happens you press an or ho" mu"tip"e )uttons together9 an for ifferent urations. #include #include #include void setup() {

*age 5 of (0



// put your setup code here to run once! Seril.e-in(56)% Timer".initili$e()% MFS.initili$e(&Timer")% // initili$e multi'unction shield lirry 4

void loop() { // put your min code here to run repetedly! yte tn 7 MFS.-et8utton()% // *ormlly it is suicient to compre the return // vlue to predeined mcros e.-. 89TTO*:":;+SS+= // 89TTO*:":O*?:;+SS+= etc. i (tn) { yte utton*umer 7 tn & 8""""""% yte utton@ction 7 tn & 8""% Seril.print(A89TTO*:A)% Seril.3rite(utton*umer B CC)% Seril.print(A:A)%

i (utton@ction 77 89TTO*:;+SS+=:D*=) { Seril.println(A;+SS+=A)% 4 else i (utton@ction 77 89TTO*:SEOT:++@S+:D*=) { Seril.println(ASEOT:++@S+A)% 4 else i (utton@ction 77 89TTO*:O*?:;+SS+=:D*=) { Seril.println(AO*?:;+SS+=A)% 4 else i (utton@ction 77 89TTO*:O*?:++@S+:D*=) { Seril.println(AO*?:++@S+A)% 4

4 4

Writing to the shield’s digit display ;he management of the mu"ti#function shie"-s igit isp"ay is performe in the )ackgroun using interrupts9 8hich means your app"ication can continue to focus on performing its main task. $tring9 integer an f"oat va"ues are 8ritten to the isp"ay as emonstrate in the sketch )e"o8? #include #include #include void setup() { // put your setup code here to run once! Timer".initili$e()% MFS.initili$e(&Timer")% MFS.3rite(AEiA)% dely()% MFS.3rite('1)% dely()% MFS.3rite(1."0" )% dely()% 4


// disply to  deciml plces.

int counter7% yte ended 7 lse%

*age  of (0



void loop() { // put your min code here to run repetedly!

4

i (counter < ) { MFS.3rite((int)counter)% counterBB% 4 else i (Gended) { ended 7 true% MFS.3rite(A+ndA)% MFS.lin,=isply(=D?DT:@ O*)% 4 dely(2)%

Controlling the shield’s LED lights A"though it isn-t strict"y necessary to use the mu"ti#function shie" "i)rary to contro" the  "ights of the shie"9 support is provie in cases 8here your app"ication nees the s to perform )asic )"ink operations. B"inking is manage in the )ackgroun using interrupts. #include #include #include void setup() { // put your setup code here to run once! Timer".initili$e()% MFS.initili$e(&Timer")%


MFS.3riteeds(+=:@ O*)% dely()% MFS.lin,eds(+=:" H +=: O*)% dely()% MFS.lin,eds(+=:" H +=: OFF)% MFS.lin,eds(+=:1 H +=:0 O*)% dely()% MFS.lin,eds(+=:@ O*)% dely()% MFS.lin,eds(+=:@ OFF)% MFS.3riteeds(+=:@ OFF)% 4 void loop() { // put your min code here to run repetedly! 4

Reading the alue of the shield’s potentiometer ;his sketch emonstrates ho8 the va"ue of the preset pot is rea an isp"aye on the mu"ti#function shie". After up"oaing this sketch9 turn the scre8 of the potentiometer to see the reaing change on the igit isp"ay. #include #include #include void setup() { // put your setup code here to run once! Timer".initili$e()%

*age 3 of (0


MFS.initili$e(&Timer")%



4 void loop() { // put your min code here to run repetedly! MFS.3rite(nlo-ed(;OT:;D*))% dely(")% 4

A"" the coe samp"es an app"ications have )een teste an 8ork. %f you e@perience any ifficu"ties9 p"ease "eave a comment9 an %-"" get )ack to you as soon as % can.

*age < of (0



Part 2 Reading Sensors ;his is part t8o of the App"ie Hackatronics $eries for the Aruino !u"ti#function shie"9 an sho8s ho8 the mu"ti#function shie" "i)rary can )e use to rea va"ues from e@terna" sensors9 such as temperature9 sonar an motion sensors9 an ho8 to process e"ectronic pu"ses from an e@terna" source. %f you haven-t a"reay one so9 you-"" nee to o8n"oa the source coe an insta"" the "i)raries using the "inks in the introuction. By fo""o8ing the Hackatronics series9 you agree to o so at your o8n risk9 an agree to take fu"" responsi)i"ity for any "oss or amages you may incur upon yourse"f or others.

Counting pulses ;he mu"ti#function shie" "i)rary has support for counting pu"ses Cup to 500H>D app"ie to an input pin of the Aruino. ;he counting of pu"ses is manage in the )ackgroun using interrupts9 8hich a""o8s your app"ication to focus on performing its main task. After up"oaing this sketch9 repeate"y press )utton 1 to generate the pu"ses an see a reaing of the press rate on the igit isp"ay. #include #include #include void setup() { // put your setup code here to run once! Timer".initili$e()% MFS.initili$e(&Timer")% // initili$e multi'unction shield lirry MFS.init;ulseDnIounter( 89TTO*:":;D* // use utton " s mens o -enertin- pulses. "2 // the numer o milliseconds to 3it or  pulse eore resettin- pulse in period to . OW // tri--er pulse on OW input. )% 4

void loop() { // put your min code here to run repetedly! // ?et the period o the most recent pulse (in milliseconds). // *OT+! pulse mesurements re ctully perormed usin- interrupts. unsi-ned int pulse;eriodMs 7 MFS.-et;ulseDn;eriod()% i (pulse;eriodMs 77 ) { MFS.3rite(. ")% 4 else { MFS.3rite(". / pulse;eriodMs ")% to " deciml plce. 4 4

*age  of (0

// clculte pulses per second. =isply



Reading the temperature using an LM!" sensor ;he mu"ti#function shie" has a socket for accepting an !(5 temperature sensor9 8hich must )e inserte correct"y9 other8ise you may irrepara)"y amage your Aruino9 or computer connecte to it. ou 8i"" kno8 8hen the sensor is incorrect"y connecte9 )ecause it 8i"" )ecome very hot. ;he mu"ti#function shie" "i)rary provies three "eve"s of fi"tering for smoothing the reaings from this sensor?

#include #include #include // *OT+! m,e sure Jumper K" is removed rom shield nd tht M12 is inserted correctly. void setup() { // put your setup code here to run once! Timer".initili$e()% MFS.initili$e(&Timer")% // initili$e multi'unction shield lirry // Dnitili$e usin-  lo3 pss ilter. // Ihoose either! SMOOTED*?:*O*+ SMOOTED*?:MO=+@T+ or SMOOTED*?:STO*? MFS.initM12(SMOOTED*?:MO=+@T+)% 4 void loop() { // put your min code here to run repetedly! int tempIenti-rde 7 MFS.-etM12=t()% // -et centi-rde in "/" o de-ree. MFS.3rite((lot)tempIenti-rde / " ")%

// disply temp to " deciml plce.

dely(")% 4

Using an #C $R%& sonar module /hen using an H& $406 sonar mou"e9 it is avisa)"e to use the mu"ti#function shie" "i)rary to rea an ca"cu"ate istance va"ues if interrupts are turne on. ;he reason for this is that the "i)rary-s interrupt service routine affects the timing reEuirements of this sonar mou"e9 an as such the "i)rary compensates for it. ;he "i)rary a"so offers three "eve"s of fi"tering for smoothing the reaings from the sonar mou"e. ;he trigger an echo pins of the sonar mou"e are connecte to Aruino pins 5 an  respective"y.

#include #include #include const int Tri-;in 7 2%

*age 10 of (0



const int +cho;in 7 6%

void setup() { // put your setup code here to run once! pinMode(Tri-;in O9T;9T)% pinMode(+cho;in D*;9T)% Timer".initili$e()% MFS.initili$e(&Timer")%


// initili$e 3ith lo3 pss ilter! SMOOTED*?:*O*+ SMOOTED*?:MO=+@T+ or SMOOTED*?:STO*? MFS.initSonr(SMOOTED*?:MO=+@T+)% 4

void loop() { // put your min code here to run repetedly! MFS.3rite((int)MFS.-etSonr=tIm(Tri-;in +cho;in))% dely(")% 4

'etting data from an M(U)%"% motion sensor ;he mu"ti#function shie" oes not e@pose the har8are %2& pins of some Aruino )oars9 such as the eonaro. ;he fo""o8ing sketch uses the shie" "i)rary to rea ra8 va"ues from the !*U050 sensor9 using either the /ire "i)rary or a soft8are imp"ementation of %2&. o8n"oa the fu"" source coe in orer to up"oa the sketch to an Aruino9 after 8hich press )utton 1 on the shie" to togg"e reporting of sensor ata9 an press )utton 2 to cyc"e through acce"eration9 gyro an temperature va"ues.

#deine :SOFTDI:E #include #include #include #include #include ASot3reDI.hA #include ADI.hA #include AM;962.hA #deine SOFTW@+:DI M;962 M;9% void displyEedin-(yte mode)%

void setup() { Seril.e-in(56)% // put your setup code here to run once! Timer".initili$e()% #i deined (SOFTW@+:DI) // 9se sot3re DI

*age 11 of (0



// 9no nd eonrdo use pin 2 or SI nd 6 or S=@. Me-26 use pin @2 or S=@. SotDI".initili$e()% M;9.initili$e(&SotDI" M;9:=+F@9T:@==+SS << ")% #else // 9se hrd3re DI Wire.e-in()% DI".initili$e(&Wire)% M;9.initili$e(&DI" M;9:=+F@9T:@==+SS)% #endi MFS.initili$e(&Timer")% MFS.3rite(A@ccA)% 4

yte displyLlues 7 true% yte displyMode 7 %

void loop() { // put your min code here to run repetedly! yte tn 7 MFS.-et8utton()% // 9se utton " to to--le reportin- o sensor vlues. i (tn 77 89TTO*:":;+SS+=) { displyLlues 7 GdisplyLlues% i (displyLlues) { displyEedin-(displyMode)% 4 else { MFS.3rite(AOA)% 4

4

i (displyLlues) { // 9se utton  to cycle thou-h the disply modes. i (tn 77 89TTO*::;+SS+=) { displyModeBB% i (displyMode 77 1) { displyMode 7 % 4 displyEedin-(displyMode)% 4

i (displyMode 77 ) { // disply r3 ccelertion vlues. M;9.-et@ccel3()% Seril.print((lot)M;9.ccel::3 / M;9.ccelScleLlue)% Seril.print(ANtA)% Seril.print((lot)M;9.ccel::3 / M;9.ccelScleLlue)% Seril.print(ANtA)% Seril.print((lot)M;9.ccel:P:3 / M;9.ccelScleLlue)% Seril.print(ANtNnA)% 4 else i (displyMode 77 ") { // disply r3 -yrovlues M;9.-et?yro3()% Seril.print((lot)M;9.-yro::3 / M;9.-yroScleLlue)%

*age 12 of (0



Seril.print(ANtA)% Seril.print((lot)M;9.-yro::3 / M;9.-yroScleLlue)% Seril.print(ANtA)% Seril.print((lot)M;9.-yro:P:3 / M;9.-yroScleLlue)% Seril.print(ANtNnA)%

4 else i (displyMode 77 ) { // disply temperture vlue. Seril.println((lot)M;9.-etTemp"th() / ")% 4 4 dely(2)% 4

void displyEedin-(yte mode) { i (mode 77 ) { Seril.println(A@ccelertion in - ("- 7 5.Q m/s/s)A)% Seril.println(ANtNtPA)% MFS.3rite(A@ccA)% 4 else i (mode 77 ") { Seril.println(A?yro n-ulr velocity in de-rees / secondA)% Seril.println(ANtNtPA)% MFS.3rite(A?yroA)% 4 else i (mode 77 ) { Seril.println(ATemperture in de-rees celsius.A)% MFS.3rite(ATeA)% 4 4

A"" the coe samp"es an app"ications have )een teste an 8ork. %f you e@perience any ifficu"ties9 p"ease "eave a comment9 an %-"" get )ack to you as soon as % can.

*age 1( of (0



Part 3 Real orld !pplications ;his is part three of the App"ie Hackatronics $eries for the Aruino !u"ti#function shie"9 an e@p"ores 8orking app"ications using the "i)rary an the mu"ti#function shie". %f you haven-t a"reay one so9 you-"" nee to o8n"oa the source coe an insta"" the "i)raries using the "inks in the introuction. 'or each of the app"ications )e"o8 there is an accompanying on"ine vieo9 as 8e"" as a summary vieo. By fo""o8ing the Hackatronics series9 you agree to o so at your o8n risk9 an agree to take fu"" responsi)i"ity for any "oss or amages you may incur upon yourse"f or others.

Countdo*n timer ;his counto8n timer is simi"ar to a counto8n timer you might fin in a micro8ave oven. ou set the time9 start the counto8n timer9 an 8hen it reaches >ero9 the a"arm souns. ou can pause+continue the timer9 an reset to >ero. Use the mu"ti#function shie" )uttons 2 an ( to set the minutes an secons. A short press of )utton 1 starts or stops the timer9 an a "ong press resets it. *ossi)"e enhancements for this app"ication are to have a evice s8itche on on"y 8hi"st the timer is counting o8n. #include #include #include

enum Iount=o3nModeLlues { IO9*TD*?:STO;;+= IO9*TD*? 4% yte count=o3nMode 7 IO9*TD*?:STO;;+=% yte tenths 7 % chr seconds 7 % chr minutes 7 % void setup() { // put your setup code here to run once! Timer".initili$e()% MFS.initili$e(&Timer")% // initili$e multi'unction shield lirry MFS.3rite()% Seril.e-in(56)% 4

void loop() { // put your min code here to run repetedly! yte tn 7 MFS.-et8utton()% s3itch (count=o3nMode) { cse IO9*TD*?:STO;;+=! i (tn 77 89TTO*:":SEOT:++@S+ && (minutes B seconds) > ) { // strt the timer count=o3nMode 7 IO9*TD*?%

*age 16 of (0



4 else i (tn 77 89TTO*:":O*?:;+SS+=) { // reset the timer tenths 7 % seconds 7 % minutes 7 % MFS.3rite(minutesR" B seconds)% 4 else i (tn 77 89TTO*::;+SS+= HH tn 77 89TTO*::O*?:;+SS+=) { minutesBB% i (minutes > 6) { minutes 7 % 4 MFS.3rite(minutesR" B seconds)% 4 else i (tn 77 89TTO*:1:;+SS+= HH tn 77 89TTO*:1:O*?:;+SS+=) { seconds B7 "% i (seconds >7 6) { seconds 7 % 4 MFS.3rite(minutesR" B seconds)% 4 re,%

cse IO9*TD*?! i (tn 77 89TTO*:":SEOT:++@S+ HH tn 77 89TTO*:":O*?:++@S+) { // stop the timer count=o3nMode 7 IO9*TD*?:STO;;+=% 4 else { // continue countin- do3n tenthsBB%

i (tenths 77 ") { tenths 7 % seconds''%

i (seconds <  && minutes > ) { seconds 7 25% minutes''% 4

i (minutes 77  && seconds 77 ) { // timer hs reched  so sound the lrm MFS.eep(2 2 1)% // eep 1 times 2 milliseconds on / 2 o count=o3nMode 7 IO9*TD*?:STO;;+=% 4 MFS.3rite(minutesR" B seconds)% 4 dely(")%

4 re,%

4 4

+& #our ,larm Cloc

*age 15 of (0



;his app"ication emonstrates a igita" c"ock 8ith an a"arm capa)i"ity. /hen the Aruino is po8ere on9 the mu"ti#function shie" isp"ay f"ashes unti" the user sets the time. Ho" )utton 1 to set the time or a"arm. /hen setting the time use )utton ( to set the hour or minutes. *ress )utton 2 to vie8 a"arm time or cance" the a"arm if in progress. Ho"ing )utton ( ena)"es or isa)"es the a"arm C1 inicates a"arm is ena)"eD. *ossi)"e enhancements to this app"ication are to have a snoo>e feature9 or to have mu"tip"e on+off perios uring the ay for a evice. #include #include #include /R utton " ! hold to set time or lrm utton  ! press to vie3 lrm time or cncel lrm i in pro-ress utton 1 ! increment hour / minute 3hen settin- (lrm) time. Eold to to--le lrm settin-. +="

! on 7 lrm enled

R/ voltile voltile voltile voltile voltile

unsi-ned int cloc,MilliSeconds 7 % yte cloc,Seconds 7 % yte cloc,Minutes 7 % yte cloc,Eours 7 "% yte cloc,+nled 7 "%

yte lrmMinutes 7 1% yte lrmEours 7 6% voltile yte lrm+nled 7 lse% yte lrmTo--le;ressed 7 lse%

enum displyModeLlues { MO=+:IOI:TDM+ MO=+:IOI:TDM+:S+T:EO9 MO=+:IOI:TDM+:S+T:MD*9T+ MO=+:@@M:TDM+ MO=+:@@M:TDM+:S+T:EO9 MO=+:@@M:TDM+:S+T:MD*9T+ 4% yte displyMode 7 MO=+:IOI:TDM+% //''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' void setup() { Timer".initili$e()% MFS.userDnterrupt 7 cloc,DS% MFS.initili$e(&Timer")% MFS.lin,=isply(=D?DT:@)% //MFS.eep(2)% 4

void loop() { // put your min code here to run repetedly! yte tn 7 MFS.-et8utton()% s3itch (displyMode) { cse MO=+:IOI:TDM+! displyTime(cloc,Eours cloc,Minutes)%

*age 1 of (0



i (tn 77 89TTO*::;+SS+=) { MFS.eep()% // cncel the lrm. displyMode 7 MO=+:@@M:TDM+% 4 else i (tn 77 89TTO*:":O*?:;+SS+=) { MFS.lin,=isply(=D?DT:@ OFF)% MFS.lin,=isply(=D?DT:" H =D?DT:)% displyMode 7 MO=+:IOI:TDM+:S+T:EO9% cloc,+nled 7 lse% cloc,MilliSeconds 7 % cloc,Seconds 7 % 4 else i (tn 77 89TTO*:1:O*?:;+SS+= && GlrmTo--le;ressed) { lrmTo--le;ressed 7 true% lrm+nled 7 Glrm+nled% MFS.3riteeds(+=:" lrm+nled)% 4 else i (tn 77 89TTO*:1:O*?:++@S+) { lrmTo--le;ressed 7 lse% 4 re,% cse MO=+:IOI:TDM+:S+T:EO9! i (tn 77 89TTO*:":;+SS+=) { MFS.lin,=isply(=D?DT:" H =D?DT: OFF)% MFS.lin,=isply(=D?DT:1 H =D?DT:0)% displyMode 7 MO=+:IOI:TDM+:S+T:MD*9T+% 4 else i (tn 77 89TTO*:1:;+SS+= HH tn 77 89TTO*:1:O*?:;+SS+=) { cloc,EoursBB% i (cloc,Eours >7 0) { cloc,Eours 7 % 4 displyTime(cloc,Eours cloc,Minutes)% 4 re,% cse MO=+:IOI:TDM+:S+T:MD*9T+! i (tn 77 89TTO*:":;+SS+=) { MFS.lin,=isply(=D?DT:1 H =D?DT:0 OFF)% displyMode 7 MO=+:IOI:TDM+% cloc,+nled 7 true% 4 else i (tn 77 89TTO*:1:;+SS+= HH tn 77 89TTO*:1:O*?:;+SS+=) { cloc,MinutesBB% i (cloc,Minutes >7 6) { cloc,Minutes 7 % 4 displyTime(cloc,Eours cloc,Minutes)% 4 re,% cse MO=+:@@M:TDM+! displyTime(lrmEours lrmMinutes)% i (tn 77 89TTO*::SEOT:++@S+ HH tn 77 89TTO*::O*?:++@S+) { displyMode 7 MO=+:IOI:TDM+% 4 else i (tn 77 89TTO*:":O*?:;+SS+=) {

*age 13 of (0



MFS.lin,=isply(=D?DT:@ OFF)% MFS.lin,=isply(=D?DT:" H =D?DT:)% displyMode 7 MO=+:@@M:TDM+:S+T:EO9% lrm+nled 7 lse% 4 re,%

cse MO=+:@@M:TDM+:S+T:EO9! i (tn 77 89TTO*:":;+SS+=) { MFS.lin,=isply(=D?DT:" H =D?DT: OFF)% MFS.lin,=isply(=D?DT:1 H =D?DT:0)% displyMode 7 MO=+:@@M:TDM+:S+T:MD*9T+% 4 else i (tn 77 89TTO*:1:;+SS+= HH tn 77 89TTO*:1:O*?:;+SS+=) { lrmEoursBB% i (lrmEours >7 0) { lrmEours 7 % 4 displyTime(lrmEours lrmMinutes)% 4 re,%

cse MO=+:@@M:TDM+:S+T:MD*9T+! i (tn 77 89TTO*:":;+SS+=) { MFS.lin,=isply(=D?DT:1 H =D?DT:0 OFF)% displyMode 7 MO=+:IOI:TDM+% lrm+nled 7 true% MFS.3riteeds(+=:" O*)% 4 else i (tn 77 89TTO*:1:;+SS+= HH tn 77 89TTO*:1:O*?:;+SS+=) { lrmMinutesBB% i (lrmMinutes >7 6) { lrmMinutes 7 % 4 displyTime(lrmEours lrmMinutes)% 4 re,%

4 4

void displyTime (yte hours yte minutes) { chr time2U% sprint(time AV1dA (hours R ") B minutes)% MFS.3rite(time ")% 4 //'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' void cloc,DS () { // ;erorm ripple count or ll time components. i (cloc,+nled) { cloc,MilliSecondsBB% i (cloc,MilliSeconds >7 ") { cloc,MilliSeconds 7 % cloc,SecondsBB% i (cloc,Seconds >7 6) { cloc,Seconds 7 %

*age 1< of (0



cloc,MinutesBB% i (cloc,Minutes >7 6) { cloc,Minutes 7 % cloc,EoursBB% i (cloc,Eours >7 0) { cloc,Eours 7 % 4 4

// D current time coincides 3ith lrm time nd lrm is enled en--e the lrm. i (lrm+nled && (cloc,Minutes 77 lrmMinutes) && (cloc,Eours 77 lrmEours)) { MFS.eep( " // on period 2 // o period 0 // numer o cycles " // numer o loop cycles 2 // dely et3een loop cycles )% 4 4 4 4 4

#eart monitor ;his app"ication reEuires a heart )eat sensor simi"ar to the one sho8n in the image Cthat can )e purchase from various internet supp"iersD9 8hich uses infrare "ight to etect pu"ses in a finger or ear "o)e. /hen norma"i>e9 the sensor outputs an ana"ogue signa" of 2.5 vo"ts9 8hich rises an rops every time the )"oo f"o8 changes ue to a heart )eat. ;he app"ication 8orks )y counting every time the signa" rises a)ove ( vo"ts9 then rops )e"o8 2.5 vo"ts9 an measures time )et8een pu"ses to ca"cu"ate the )eats per minute. ;he )eeper is soune every time a heart )eat is etecte. ;he sensor output 8i"" nee to )e connecte to Aruino pin A5 e@pose on the mu"ti#function shie". /A4G%G7? ;his app"ication is not intene for meica" purposes. After po8ering on the Aruino9 gent"y )ut firm"y p"ace the ine@ finger on the sensor an 8ait for the isp"ay to start )"inking. ;his inicates the sensor has norma"i>e9 after 8hich the shie" isp"ay 8i"" sho8 the )eats per minute9 an the )eeper 8i"" soun. %f the isp"ay remains at 0 an oesn-t )"ink after severa" secons9 remove the finger9 8ait for a 8hi"e an try again. nsure the finger is p"ace 8ith consistent pressure. *ossi)"e moification for this app"ication is to have an  "ight synchronise 8ith each heart )eat. #include #include #include void initili$eSensoredin-()% int dt0U% yte dtDd7%

*age 1 of (0



yte pulse=etected 7 lse% int lst;ulseTime 7 '"%

void setup() { // put your setup code here to run once! Timer".initili$e()% MFS.initili$e(&Timer")% initili$eSensoredin-()% //Seril.e-in(56)% 4

void loop() { i (MFS.-etTimer() 77 ) { MFS.setTimer(")% // reset millisecond countdo3n timer. i (lst;ulseTime G7 '") { lst;ulseTime 7 " B lst;ulseTime% 4 4 int sensorLlue 7 nlo-ed(@2)%

// red the sensor.

i (sensorLlue <  HH sensorLlue > 5) { // Sensor hsnCt normli$ed chec, ho3 lon- or in milliseconds. i (lst;ulseTime G7 '" && lst;ulseTime ' MFS.-etTimer() > ) { initili$eSensoredin-()% 4 4 else i (sensorLlue > (1 R "0) / 2) // vlue is risin- so must e strt o  pulse. { i (Gpulse=etected) { pulse=etected 7 true% i (lst;ulseTime 77 '") { lst;ulseTime 7 MFS.-etTimer()% 4 else { int pulse;eriod 7 lst;ulseTime ' MFS.-etTimer()% et3een pulses in millseconds. lst;ulseTime 7 MFS.-etTimer()% int pm 7 6 / pulse;eriod%

// clculte time

// clculte ets per minute.

i (pm < 02 HH pm > 1) // pm is outside cceptile rn-e so cler the dt uer. { initili$eSensoredin-()% 4 else { // pm is 3ithin rn-e ut still need to clculte ver-e. dtdtDdBBU 7 pm% i (dtDd >7 0) { dtDd 7 % 4

*age 20 of (0



i (dtU && dt"U && dtU && dt1U) // chec, i dt uer is ull eore clcultin- v- pm. { int v-8pm 7 (dtU B dt"U B dtU B dt1U) / 0% MFS.lin,=isply(=D?DT:@ OFF)% MFS.3rite(v-8pm)% MFS.eep()%

4 else { // uer not ull so lin, the disply. MFS.lin,=isply(=D?DT:@ O*)% 4

4 4 4 4 else i (sensorLlue < ("0 / )) pulse. { pulse=etected 7 lse% 4

// vlue is llin- so must e end o

//Seril.println(sensorLlue)% //dely(")% 4

// Dnitili$e the red uer nd disply. void initili$eSensoredin-() { lst;ulseTime 7 % dtDd 7 % or (int i7% i<0% iBB) { dtiU 7 % 4 MFS.3rite()% MFS.lin,=isply(=D?DT:@ OFF)% 4

$urface incline indicator ;he surface inc"ine inicator app"ication uses the !*U050 motion sensor to etermine the ang"e of inc"ination of a f"at surface. ou 8i"" nee to o8n"oa the fu"" source coe )efore up"oaing to the Aruino. Because the app"ication uses soft8are %2&9 8hen using 4( )oars Uno an eonaro9 use pin 5 for $& an  for $A. 'or !ega2509 use pin 5 for $& an pin A5 for $A. After po8ering on the Aruino9 p"ace the motion sensor on a surface that is as "eve" as possi)"e9 then press an ho" )utton 1 on the mu"ti#function shie".  1 )"inks 8hi"e the sensor is ca"i)rate. ;hereafter9 )y p"acing the motion sensor on inc"ine surfaces the shie" 8i"" isp"ay the ang"e of inc"ination. *resent"y the inc"ine is isp"aye on"y for a sing"e a@is9 )ut the app"ication cou" moifie to the sho8 the inc"ine for an aitiona" a@is. #deine :SOFTDI:E #include #include #include #include

*age 21 of (0



#include ASot3reDI.hA #include ADI.hA #include AM;962.hA #deine SOFTW@+:DI void clirte()% M;962 M;9% const lot rdTo=e- 7 "Q. / 1."0"256212Q5511Q066011Q152% int Oset7 yOset7% lot $ScleOset 7 "% // multiply P is 3ith this vlue to -et s close to "s possile.

void setup() { // put your setup code here to run once! Timer".initili$e()% #i deined (SOFTW@+:DI) // 9se sot3re DI // 9no nd eonrdo use pin 2 or SI nd 6 or S=@. Me-26 use pin 2 or SI nd pin @2 or S=@. SotDI".initili$e()% M;9.initili$e(&SotDI" M;9:=+F@9T:@==+SS << " @II+:FS: ?O:FS:2 =;F:8W:2)% #else // 9se hrd3re DI Wire.e-in()% DI".initili$e(&Wire)% M;9.initili$e(&DI" M;9:=+F@9T:@==+SS @II+:FS: ?O:FS:2 =;F:8W:2)% #endi MFS.initili$e(&Timer")% 4 void loop() { // put your min code here to run repetedly! yte tn 7 MFS.-et8utton()% i (tn 77 89TTO*:":O*?:;+SS+=) { clirte()% 4 M;9.-et@ccel3()% M;9.ccel::3 '7 Oset% M;9.ccel::3 '7 yOset% lot n-le% i (M;9.ccel:P:3 77 ) { n-le 7 5% 4 else { n-le 7 tn((lot)M;9.ccel::3 / (M;9.ccel:P:3 R $ScleOset)) R rdTo=e-% // clculte or y is //n-le 7 tn((lot)M;9.ccel::3 / (M;9.ccel:P:3 R $ScleOset)) R rdTo=e-% // clculte or  is 4 MFS.3rite(n-le ")% dely()% 4

*age 22 of (0



void clirte() { MFS.3rite(A A)% MFS.3riteeds(+=:" O*)% MFS.lin,eds(+=:" O*)% // discrd irst e3 sensor redin-s. or (int i7% i<"% iBB) { M;9.-et@ccel3()% dely(")% 4 int Llues2U yLlues2U $Llues2U% or (int i7% i<2% iBB) { M;9.-et@ccel3()% LluesiU 7 M;9.ccel::3% yLluesiU 7 M;9.ccel::3% $LluesiU 7 M;9.ccel:P:3% dely(1)% 4 Oset 7 MedinO2(LluesU Llues"U LluesU Llues1U Llues0U)% yOset 7 MedinO2(yLluesU yLlues"U yLluesU yLlues1U yLlues0U)% $ScleOset 7 (lot)M;9.ccelScleLlue / MedinO2($LluesU $Llues"U $LluesU $Llues1U $Llues0U)% MFS.lin,eds(+=:" OFF)% // cler the input utton uer y redin- it nd discrdin- vlue. or (int i7% i<"% iBB) { MFS.-et8utton()% 4 4

$onar ranger ;he sonar ranger app"ication uses the H& $406 sonar mou"e to measure istance )et8een the mou"e an a so"i o):ect up to 5 meters a8ay. ;his app"ication 8orks in a 8ay simi"ar to the o)stac"e sensor of some vehic"es the assist the river in parking manoeuvres. As an o)stac"e nears the sonar mou"e9 the )eeper is soune at shorter an shorter interva"s. ;he shie"-s )utton 1 is use for engaging or isengaging the sonar mou"e. ;he trigger an echo pins of the sonar mou"e are connecte to Aruino pins 5 an  respective"y9 8hich are e@pose on the mu"ti#function shie". After po8ering on the Aruino9 p"ace a so"i o):ect at ifferent istances a8ay from the sonar mou"e. #include #include #include const int Tri-;in 7 2% const int +cho;in 7 6% enum sonrModeLlues { MO=+:SO*@:OFF MO=+:SO*@:O* 4% yte sonrMode 7 MO=+:SO*@:OFF% void setup()

*age 2( of (0



{ //Seril.e-in(56)% pinMode(Tri-;in O9T;9T)% pinMode(+cho;in D*;9T)% Timer".initili$e()% MFS.initili$e(&Timer")% MFS.3rite(AoA)% 4 void loop() { yte tn 7 MFS.-et8utton()% s3itch (sonrMode) { cse MO=+:SO*@:OFF! i (tn 77 89TTO*:":;+SS+=) { sonrMode 7 MO=+:SO*@:O*% MFS.eep(2 52 ")% MFS.3rite(AonA)% 4 re,% cse MO=+:SO*@:O*! i (tn 77 89TTO*:":;+SS+=) { sonrMode 7 MO=+:SO*@:OFF% MFS.eep()% MFS.3rite(AoA)% MFS.lin,=isply(=D?DT:@ OFF)% MFS.initSonr()% 4 else { int distnce 7 MFS.-etSonr=tIm(Tri-;in +cho;in)%

i (distnce G7  && distnce < ) { int o;eriod 7 distnce ' 6% i (o;eriod < ) { o;eriod 7 % 4 MFS.3rite(distnce)% MFS.set8eepO;eriod(o;eriod)%

MFS.lin,=isply(=D?DT:@ distnce < "")% 4 dely(")%

4 re,%

4 4

$peedometer ;he speeometer app"ication ca"cu"ates the spee of a 8hee" Cin ki"ometres+hourD )y using a magnet an a ree s8itch9 8hich is connecte to Aruino pin 5. %t shou" a"so )e possi)"e to fa)ricate your o8n 8hee" encoer using a "ine or mark sensor. After po8ering on the Aruino9 press an ho" )utton 1 of the mu"ti#function shie" unti" the isp"ay )"inks9 then use )uttons 2 an ( to set the 8hee" iameter in centimetres. *ress )utton 1 again 8hen finishe. ;urn the 8hee" to see the spee inicate on the shie" isp"ay.

*age 26 of (0



A possi)"e enhancement for this app"ication is to keep a recor of trip istance in ki"ometres. #include #include #include

enum SpeedoModeLlues { S+T9;:WE++ I@I9@T+:S;++= 4% yte speedoMode 7 I@I9@T+:S;++=% yte 3heel=imeterIm 7 6% unsi-ned int 3heelIirmcumerenceIm 7 (3heel=imeterIm R 1"0) / "% lot Speedmh (unsi-ned int 3heelIircumerenceIm unsi-ned int periodMs)%

void setup() { // put your setup code here to run once! pinMode(2 D*;9T:;99;)% Timer".initili$e()% MFS.initili$e(&Timer")% MFS.init;ulseDnIounter( 2 // use di-itl pin 2 or pulse input.  // the numer o milliseconds to 3it or  pulse eore resettin- pulse in period to . OW // tri--er pulse on OW input. )% 4

void loop() { // put your min code here to run repetedly! yte tn 7 MFS.-et8utton()% s3itch (speedoMode) { cse S+T9;:WE++! i (tn 77 89TTO*:":;+SS+=) { speedoMode 7 I@I9@T+:S;++=% MFS.lin,=isply(=D?DT:@ OFF)% 3heelIirmcumerenceIm 7 (3heel=imeterIm R 1"0) / "% 4 else i (tn 77 89TTO*::;+SS+= HH tn 77 89TTO*::O*?:;+SS+=) { 3heel=imeterIm''%

i (3heel=imeterIm < 1) { 3heel=imeterIm 7 1% 4 MFS.3rite(3heel=imeterIm)% 4 else i (tn 77 89TTO*:1:;+SS+= HH tn 77 89TTO*:1:O*?:;+SS+=) { 3heel=imeterImBB% i (3heel=imeterIm > ") { 3heel=imeterIm 7 "% 4

*age 25 of (0



MFS.3rite(3heel=imeterIm)% 4 re,% cse I@I9@T+:S;++=! i (tn 77 89TTO*:":O*?:;+SS+=) { speedoMode 7 S+T9;:WE++% MFS.3rite(3heel=imeterIm)% MFS.lin,=isply(=D?DT:@ O*)% 4 else { unsi-ned int pulse;eriodMs 7 MFS.-et;ulseDn;eriod()% i (pulse;eriodMs 77 ) { MFS.3rite(. ")% 4 else { MFS.3rite(Speedmh(3heelIirmcumerenceIm pulse;eriodMs) ")% 4 4 re,%

4 dely(")% 4

lot Speedmh (unsi-ned int 3heelIircumerenceIm unsi-ned int periodMs) { return (lot)(3heelIircumerenceIm R 16) / periodMs% 4

A"" the coe samp"es an app"ications have )een teste an 8ork. %f you e@perience any ifficu"ties9 p"ease post a comment9 an %-"" get )ack to you as soon as % can.

*age 2 of (0



!ppendices Multi-function $hield Library #elp #deine O* " #deine OFF  #deine #deine #deine #deine #deine #deine #deine #deine #deine #deine #deine #deine #deine

+=:":;D* +=::;D* +=:1:;D* +=:0:;D* ;OT:;D* 8++;+:;D* 89TTO*:":;D* 89TTO*::;D* 89TTO*:1:;D* @TIE:;D* I:;D* =@T@:;D* M12:;D*

#deine #deine #deine #deine #deine

=D?DT:" " =D?DT:  =D?DT:1 0 =D?DT:0 Q =D?DT:@ "2

#deine #deine #deine #deine #deine

+=:" " +=:  +=:1 0 +=:0 Q +=:@ "2

"1 " "" "  1 @" @ @1 0  Q @0

// utton stte indictors #deine 89TTO*:;+SS+=:D*= #deine 89TTO*:SEOT:++@S+:D*= #deine 89TTO*:O*?:;+SS+=:D*= #deine 89TTO*:O*?:++@S+:D*=

( (" ( (1

<< << << <<

6) 6) 6) 6)

#deine #deine #deine #deine

89TTO*:":;+SS+= 89TTO*:":SEOT:++@S+ 89TTO*:":O*?:;+SS+= 89TTO*:":O*?:++@S+

(" (" (" ("

H H H H

89TTO*:;+SS+=:D*=) 89TTO*:SEOT:++@S+:D*=) 89TTO*:O*?:;+SS+=:D*=) 89TTO*:O*?:++@S+:D*=)


89TTO*::;+SS+= 89TTO*::SEOT:++@S+ 89TTO*::O*?:;+SS+= 89TTO*::O*?:++@S+

( ( ( (

H H H H



89TTO*:1:;+SS+= 89TTO*:1:SEOT:++@S+ 89TTO*:1:O*?:;+SS+= 89TTO*:1:O*?:++@S+

(1 (1 (1 (1

H H H H


#deine SMOOTED*?:*O*+ #deine SMOOTED*?:MO=+@T+ #deine SMOOTED*?:STO*?

 " 

clss MultiFuncShield { pulic! // ;ointer to user interrupt 3ith reXuency o ",h$. void (RuserDnterrupt)() 7 *9% // Dnitili$es this instnce usin-  TimerOne instnce. @ ",h$ interrupt is ttched. void initili$e(TimerOne Rtimer")%

*age 23 of (0



// Dnitili$es this instnce ut interrupt sed etures re not ville. void initili$e()% // For internl use only. void isrIll8c,()% // Dnitites  millisecond countdo3n timer. void setTimer (unsi-ned lon- thousndths)% // ?ets the current vlue o the countdo3n timer. unsi-ned lon- -etTimer()% // Dnitites nd 3its or millisecond countdo3n timer to rech . void 3it(unsi-ned lon- thousndths)% // Writes to the += di-it disply. void 3rite(const chr Rtetstrin- yte ri-htKustiy 7)% void 3rite(int inte-er)% void 3rite(lot numer yte deciml;lces 7 ")% // Mnully rereshes the ed di-it disply. // *ot to e used 3hilst interrupt sed etures re ville. void mnul=isplyeresh()% // 8lin,s the di-its on the += di-it disply. void lin,=isply(yte di-its // use it3ise O e.-. =D?DT:" H =D?DT: yte enled 7 O* // turns on/o the lin,in)% // Turns +=s on or o. void 3riteeds(yte leds yte lit )%

// use it3ise O e.-. +=:" H +=: // O* or OFF

// 8lin,s the +=s. void lin,eds(yte leds yte enled 7 O* )%

// use it3ise O e.-. +=:" H +=: // O* or OFF

// +n--e the eeper 3hich is mn-ed in the c,-round. ;eriod timin- is in "th o second void eep(unsi-ned int on;eriod 7  unsi-ned int o;eriod 7  yte cycles 7 " unsi-ned int loopIycles 7 " /R 7indeinitely R/ unsi-ned int loop=ely;eriod 7)% // 9se this to set the o period 3hilst the eeper is en--ed void set8eepO;eriod(unsi-ned int o;eriod)% // Yueues  utton ction to the utton Xueue e.- 89TTO*:":;+SS+= void Xueue8utton (yte utton)% // ;ulls  utton ction rom the utton Xueue. yte -et8utton()% // Yueues utton short press nd relese ctions. on- utton presses re not supported nd lon- releses re reported s short releses. // Should not e used 3hilst interrupt sed etures re ville. void mnul8uttonEndler()% // Dnitili$es the pulse counter. 9sed or countin- pulses M pulse reXuency 2h$. void init;ulseDnIounter(yte pin 7 89TTO*:":;D* // unsi-ned int timeOut 7 1 // to 3it or  pulse eore resettin- pulse in period to . yte tri--er 7 OW // risin- or llin- ed-e )%

pplied to n input pin. input pin the numer o milliseconds tri--er counter on either

// ?ets the period o the most recent pulse (in milliseconds). unsi-ned int -et;ulseDn;eriod()%

*age 2< of (0



// ?ets the totl numer pulses counted. unsi-ned lon- -et;ulseDnTotlIount()% // esets the pulse counter to . void reset;ulseDnTotlIount()% // Sets the pulse in timeout 3hich is the numer o milliseconds to 3it or  pulse eore resettin- pulse in period to . void set;ulseDnTimeOut(unsi-ned int timeOut)% // Dnitili$es the sonr redin- eture. *eeds EI'S0 sonr module. void initSonr(yte level 7 SMOOTED*?:MO=+@T+)% // level 7none "7moderte 7stron-. // ?ets the distnce mesured in centimeters usin- EI'S0 sonr module. unsi-ned int -etSonr=tIm(yte tri--er;in yte echo;in)% // Dnitili$es temperture redin- eture. *eeds M12 sensor. Must remove Jumper K" rom shield. void initM12(yte level 7 SMOOTED*?:MO=+@T+)% // level 7none "7moderte 7stron// ?ets the temperture redin- in " tenths o  centi-rde. int -etM12=t()% 4% etern MultiFuncShield MFS%

*age 2 of (0

Hackatronics Arduino Multi Function Shield

Recommend Documents