LattePanda DFR0418 User manual

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 1/58
CONTENTS
GettingStartedwithLattePanda
PoweronyourLattePanda
Connectwithyourperipheraldevice
ConnecttoWi-Fi
Connectwith7“DisplayandTouchPanelOverlay
Software&OperatingSystems
HowtosetupaVNCserverontheLattePandausingTightVNC
Hardware&Accessories
InputsandOutputs
HowtoaccesspinoutsfromVisualStudio
ProjectExamples
Node-RED
TurnaLattePandaintoa3DPrintServerUsingOctoprint
FaceDetectionusingOpenCV
Troubleshooting&FAQs
HowdoIknowLattePandaison?
HowdoIre-installLattePandaWindowssystem?
WhatBootMethodDoesLattePandaUse?
CommonAdaptersandUSBcablerecommendations
GETTING STARTED
Power on your LattePanda
TheLattePandaispoweredthroughthemicroUSBport.AnystandardUSBadapter(suchasacellphonewallcharger)with
atleast2AofcurrentcanbeusedasapowersupplyfortheLattePanda.Apoweradapterwillnotbebundledwiththe
board,butyoumaygetonefromouronlinestoreoranyelectronicsretailer.
Note:CheckyourpoweradapterandUSBcableconnectionbeforeuse.Insufficientorunstablecurrentmaypreventyour
LattePandafrominitializing.
Here’sourlistofrecommendedpoweradaptersandcables
WhenyouhaveanadapterandmicroUSBcableready,followtheinstructionsbelowtogetstartedwithyourLattePanda.
1.PlugtheUSBintotheUSBpoweradapter,andthemicroUSBintothemicroUSBportoftheLattePanda(ThemicroUSB
portislocatednexttotheSDcardsocket).
IfyouneedIPSdisplayandtouchpanel,pleaseplugitfirst
Welcome

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 2/58
2.Whenpluggedin,youshouldseetheredLEDindicatorlightsupontheundersideoftheboard.Thismeansthatthe
LattePandaisinitializing.WaitpatientlyforafewsecondsuntiltheLEDgoesout.
3.WhentheLEDturnsoff,pressandholdthepowerbuttonforonesecondtoturntheLattePandaon.Youshouldseethe
LEDlightsupagain

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 3/58
Connect with your peripheral device
LattePandaiscompatiblewithawiderangeofperipheraldevices.
YoumayconnectanyUSBsupporteddevices,suchflashdrives,mouseandkeyboard,orawebcamtoUSB3.0and2.0ports.
TheSDcardsocketsupportsextrastoragefromaminiSDcard.YoumayalsoconnecttheLattePandatoanexternal
speakerdevicethroughits3.5mmaudiojack.
TheLattePanda’sArduinocompatibleco-processorwithplugandplayheadersandGPIOpinssupportsstandard5V
sensorsandactuatorsthatenableittointeractwiththephysicalworld.

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 4/58
Connect to Wi-Fi
1.InstalltheWi-Fiantennabypluggingtheroundshapedendintothesocketlabelled“ANT”locatednexttotheGPIOpins
ontheboard.
2.InWindowsselectaWi-FiconnectionbyclickingtheWi-Fiiconinthesystemtrayatthebottomrightofthescreen.Follow
thewizardtosetupaconnection.
Note:AweakWi-FisignalmaypreventaWi-Ficonnectionbeingestablished.Checktheantennaisconnectedproperlyto
theboardandmakesurethataWi-Finetworkisavailable.
Connect with 7“ Display and Touch Panel Overlay

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 5/58
Note:PleaseconnectitwithLattePandaBEFOREpower-on.AndmakesuretheGoldenFingerfacetherightside.
ThecontactsonFPCaresocompactandinorder.Pleasebecarefulthatanydislocationconnectionmaycausethe
LattePandashortcircuitandtheIPSdisplayabnormallikeghostingorflicker.
1.Liftuptheactuator.Usethumborindexfingermightbeeasier.

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 6/58
2.InsertdisplayFPCin.
PlaceGoldenFingersidedown!
Note:TheFPCmustbefullyinsertedintheconnector.Ifnotfullyinserted,theactuatorwillnotcloseproperly.Shouldthis
bethecase,liftuptheactuatorandrepeattheprocess(startingwithStep1above)
3.Rotatedowntheactuatoruntilfirmlyclosed.
4.InserttheFPCoftouchpanelin
Sameasthedisplay.PlacetheGoldenFingersidedowntoo.

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 7/58
Software & Operating Systems
Setting up a VNC server on the LattePanda using TightVNC
INTRODUCTION
InthistutorialIwilldemonstratehowtoinstallaVNCserviceonyourLattePandausingWindows.Thiswillenableyouto
accesstheGUIofWindowsrunningonyourLattePandafromadifferentPConyourlocalnetwork.IwilluseTightVNC,a
freeandeasytosetupservice.
VNCstandsfor“VirtualNetworkComputing”.Itisawayoftransmittingthekeyboardandmouseeventsofonecomputer
toanother-inotherwordsusingonecomputertoremotecontrolanother.Thisisusefulbecauseyoumightnothaveextra
monitors,keyboardsormicelyingaround–usingaVNCserviceenablesyoutoaccessseveralcomputersonyourlocal
networkusingjustonecomputer,monitor,keyboardandmouse.Youmightalsohaveaheadlessserversetupwhich
doesn’trequireconstantlyattachedperipherals.SettingupaVNCserveronyourheadlessserverisahandywayto
interfacewithaGUIifandwhenyouneedit.
Let’sgetstarted:
STEP 1 - INSTALLATION
1.DownloadandinstallTightVNCforWindowsonyourLattePanda.Choose32-bitor64-bitdependingonyoursystem
architecture.
(LattePandaStandardis32-bit,LattePandaEnhancedis64-bit)

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 8/58
Download(http://www.tightvnc.com/download.php)
2.End-UserLicenceAgreement
Acceptthelicenceagreementandclicknext
3.ChooseSetupType
TypicalinstallationwillinstallbothTightVNCserverandTightVNCvieweronyourLattePanda
Custominstallationallowsyoutoselectwhichelementstoinstall.Reallyallweneedistheserver,unlessyouwouldlike

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 9/58
tobeabletoviewotherPCsonyournetworkthroughtheLattePanda,inwhichcaseyouwillneedthevieweraswell.
Forthistutorialwewilljustdothetypicalinstall.

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 10/58
4.SelectAdditionalTasks
Checkalltheboxes

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 11/58
5.ReadytoInstallTightVNC
ClickInstalltobegin!

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 12/58
6.TightVNCServer:SetPasswords
Password-basedA
Atthispointitiswisetosetapasswordforremoteaccess.Pointtheradiobuttontowards“Requirepassword-based
authentication”andchooseapassword.Retypeitinthefollowingbox.
Ihavesetthepasswordas“lattepan”(asthepasswordcan’tbelongerthan8characters)
7.AdministrativePassword
Thisisnotstrictlynecessary.InthistutorialIwillnotsetanadministrativepassword,butyoumayifyouwish.Ifyouset
apasswordforthisyouwillhavetoenteritbeforechanginganyconfigurationsettings.
Whenyouarehappywithyoursettings,click“OK”.Click“Finish”toexitthesetupwizard.
STEP 2 - CONFIGURATION

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 13/58
Youshouldnowseeanewiconinyoursystemtray.(Ifyoudon’t,tryloggingoutandloggingbackintoyourPC).
HereyoucanseetheIPaddressyourPCison.
Doubleclickittobringuptheserviceconfigurationwindow.Thedefaultsettingsshouldbefineforourpurposes.
Next,youwillneedtogoontothecomputeryouwouldliketocontroltheLattePandawithandusingthesameinstallation
package,installTightVNCviewer.
WhenyouhavesuccessfullyinstalledTightVNCviewer,checkthatyouareonthesamenetworkasyourLattePanda,
otherwiseitwillnotwork!
WhenyouarecertainthatyourcomputerandtheLattePandaareonthesamelocalnetwork,proceedtostep3
STEP 3 - TESTING

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 14/58
OpenTightVNCViewer.AwindowwillappearforanewTightVNCConnection.Atthispoint,youneedtoinputtheIP
addressofyourLattePanda.
Tip:AquickwayoffindingthisisifyouhoveroverthesystemtrayTightVNCicononyourLattePanda.Ahintwillpopup
with“TightVNCService-”Youcouldalsogointoyourroutercontrolinterfaceandlookforattacheddevices.
ThenextstepistoinputthisIPaddressintheNewTightVNCConnectionWindow,followedbytheportnumberyousetin
theservicesettings.Thedefaultisport5900.
<ipaddressofLattePanda>:<portnumber>
e.g.192.168.2.60:5900
Clickconnect.Ifallgoeswellyouwillbepromptedwithapasswordinput.Inputthepasswordyousetearlier.Mypassword
was“lattepan”.Pressenter.
YouwillbegreetedbyawindowcontainingyourLattePanda’sGUI!Youmaynowcontrolitremotely!

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 15/58
ThisconcludestheLattePandaVNCtutorial.Ifyouhaveanyquestionsorcommentspleaseletusknowintheforum.Ihope
thishasbeenofhelptoyou.
Hardware & Accessories
Inputs and Outputs
InthisarticlewewilldiscusstheimagesoftheLattepanda.Belowisabasicdiagramthatdisplaysallthepins:

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 16/58
PinoutsinareaU1areassignedtotheX-Z8300core.
PinoutsinareaU2areassignedtotheATmega32u4core.
Eachofthe20digitalpins(A0-A5,D0-D13)inareaU2canbeusedasaninputoroutput,eachoperatingat5volts.Each
pincanoutputorreceive40mAandeachhasaninternalpull-upresistor(disconnectedbydefault)of20-50kohm.
Caution:Exceeding40mAonanyI/OpinmaycausepermanentdamagetotheATmega32u4.
Somepinshavespecializedfunctions:
AnalogInputs:A0-A5,A6-A11(onD4,D6,D8,D9,D10,andD12).TheLattePandahas12analoginputs,labeledA0through
A11,allofwhichcanalsobeusedasdigitalI/O.Eachpinhasa10bitresolution(i.e.1024differentvalues).Bydefaultthey
measurefromgroundto5volts.
Serial:D0(RX)andD1(TX).Usedtoreceive(RX)andtransmit(TX)TTLserialdata.
ExternalInterrupts:D3(interrupt0),D2(interrupt1),D0(interrupt2),D1(interrupt3)andD7(interrupt4).Thesepinscan
beconfiguredtotriggeraninterruptonalowvalue,arisingorfallingedge,orachangeinvalue.
PWM:D3,D5,D6,D9,D10,andD13provide8-bitPWMoutput.
SPI:D16(MOSI),D14(MISO),D15(SCK).
LED:D13Thereisabuilt-inLEDdrivenbydigitalpin13.Whenthepin'sval
TWI:D2(SDA),D3(SCL).
Otherpinsontheboard:
Reset:
BringthislineLOWtoresetthemicrocontroller.Typicallyusedtoaddaresetbuttontoshieldswhichblocktheoneonthe
board.
How to access pinouts from Visual Studio
LATTEPANDA.FIRMATA
LattePanda.Firmata(https://github.com/LattePandaTeam/LattePanda-Development-
Support/tree/master/LattePandaFirmata)isanopen-sourceFirmatalibraryprovidedbyLattePanda,whichissuitablefor
WindowsappsdevelopedinVisualStudio.ThisclassallowsyoutocontrolArduinoGPIOfromWindowsapps,withfeatures
including:
●Readingandwritingtodigitalpins
●Readinganaloginputs
●Controllingservomotors
●SendingdatatodevicesandreceivingdataformdevicesthroughtheI2CBus
3 STEPS TO YOUR REMOTE ARDUINO PROJECT
1.SetupyourPC
2.SetuptheArduino(Itispre-installed,unlessyouchangedtheArduinoprogram)
3.Createaprojectorusethesampleproject(http://www.lattepanda.com/wp-
content/uploads/2016/02/blinkYourBoard.zip)
FUNCTIONALITY
CONSTRUCTOR
publicArduino();
publicArduino(stringserialPortName,Int32baudRate,boolautoStart,intdelay);
publicArduino(stringserialPortName);
publicArduino(stringserialPortName,Int32baudRate);
Therearefourdifferentconstructors,youcanchoosetheproperonedependingonyourneeds
Parameters
serialPortName: SpecifyserialportnamewhichyoucanfindintheDeviceManager
baudRate: Itspecifiestheserialportspeed,thevaluemustbethesameasArduinoFirmata.Thedefaultvalueis57600.

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 17/58
autoStart: ConnecttheArduinoautomaticallywhenitistrue.Defaultvalue:True
delay: Setthemaximumintervalinsecondsofserialconnectiontimeout.Defaulttime:8Seconds
CONFIGURATION
publicvoidpinMode(intpin,bytemode);
Setsthemodeofthespecifiedpinasyouwish
Parameters
pin: thenumberofthepinwhosemodeyouwishtoset
mode: Arduino.OUTPUT , Arduino.INPUT , Arduino.PWM , Arduino.SERVO
Returns
None
DIGITAL
publicvoiddigitalWrite(intpin,bytevalue);
WritetoadigitalpinthathasbeentoggledtooutputmodewithpinMode()method
Parameters
pin: Thedigitalpintowriteto
value: Arduino.HIGH , Arduino.LOW
Returns
None
publicintdigitalRead(intpin);
Returnsthelastknownstateofthedigitalpin
Parameters
pin: TheArduinodigitalinputpin
Returns
Arduino.HIGH or Arduino.LOW
publiceventDigitalPinUpdateddigitalPinUpdated;
CallthisCallbackfunctionwhenthedigitalvalueofthepinwhosemodehasbeensetas Arduino.INPUT update
Delegate
publicdelegatevoidDigitalPinUpdated(bytepin,bytestate);
Parameters
pin: thepinwhosevaluewillupdate
state: Arduino.HIGH , Arduino.LOW
Returns
None
ANALOG
publicvoidanalogWrite(intpin,intvalue);
WritetoananalogpinusingPulse-widthmodulation(PWM)
Parameters
pin: Analogoutputpin
value: PWMfrequencyfrom0(alwaysoff)to255(alwayson)
Returns
None
publicintanalogRead(intpin);
Returnsthelastknownvalueoftheanalogpin
Parameters
pin: TheArduinoanaloginputpin(0~5)
Returns
int: Avaluerepresentingtheanalogvaluebetween0(0V)and1023(5V)
publiceventAnalogPinUpdatedanalogPinUpdated;
Callthisfunctionwhentheanalogvalueofpinwhosemodehasbeensetas Arduino.INPUT update
Delegate
publicdelegatevoidAnalogPinUpdated(intpin,intvalue);
Parameters
pin: thepinwhosevalueupdate
value: Avaluerepresentingtheanalogvaluebetween0(0V)and1023(5V)

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 18/58
Returns
None
SERVO
publicvoidservoWrite(intpin,intangle); WritetheangletospecifiedpinwhichhasbeensetthemodeasServo
Parameters
pin: Servooutputpin.
value: Anglefrom0to180.
Returns
None
I2C/TWOWIRE
publicvoidwireBegin(Int16delay);
InitiatetheWirelibraryandjointheI2Cbusasamaster.Thisshouldnormallybecalledonlyonce
Parameters
delay: thenumberofmillisecondstopause(ms).
Returns
None
publicvoidwireRequest(byteslaveAddress,Int16slaveRegister,Int16[]data,bytemode);
RequestI2Cdevicestosendorreceivedata,thencall didI2CDataReveive eventtohandledatawhenreceivedata.
Parameters
slaveAddress: the7-bitaddressofthedevicetorequestbytesfrom
slaveRegister: Specifytheregisterthatyouwanttostoredataorreaddata,choose Arduino.NONE ifthereisempty.
data :
1.whensettheParameter mode as Arduino.I2C_MODE_WRITE ,thedatasuchas {0x00,0x01} willbesendingtodevices
throughI2CBUS.
2.whensettheParameter mode as Arduino.I2C_MODE_READ_ONCE or Arduino.I2C_MODE_READ_CONTINUOUSLY ,dataspecifythe
lengthofreceiveddata.
mode :
1. Arduino.I2C_MODE_WRITE :Senddata
2. Arduino.I2C_MODE_READ_ONCE :Receivedataonce
3. Arduino.I2C_MODE_READ_CONTINUOUSLY :Receivedatacontinuous
4. Arduino.I2C_MODE_STOP_READING :Stopreceivingdata
Returns
None
publiceventDidI2CDataReveivedidI2CDataReveive;
CallthiseventwhenreceiveI2Cdata.
Delegate
publicdelegatevoidDidI2CDataReveive(byteaddress,byteregister,byte[]data);
Parameters
address: :Specifyslavecomputeraddress
register: :Specifyregisteraddress
data: :Datareturned
Returns
None
EXAMPLES
DIGITALWRITE
Inthisexample,wewillblinktheLEDwhichisconnectedwithdigitalpin(D0-D13)
APIRequired:
1.publicArduino();
2.publicvoidpinMode(intpin,bytemode);

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 19/58
3.publicvoiddigitalWrite(intpin,bytevalue);
HardwareRequired:
1.LattePandax1
2.ledx1（oryoucanusetheLEDattachedtopin13ontheArduinoboarditself）
Circuit:
1.LEDinserteddirectlyintopin13
Code:
1.CreateanewprojectinVisualStudio,RefertoCreateaproject
2.Mainfunctioncode:
usingSystem;
usingSystem.Collections.Generic;
usingSystem.Linq;
usingSystem.Text;
usingSystem.Threading.Tasks;
usingSystem.Threading;
usingLattePanda.Firmata;
namespaceblinkYourBoard//projectname
{
classProgram

10/26/2016 Docs|LattePanda
http://www.lattepanda.com/docs/ 20/58
{
staticArduinoarduino=newArduino();//createaninstanceandinitializewiththedefaultparameters
staticvoidMain(string[]args)
{
arduino.pinMode(13,Arduino.OUTPUT);//Setthedigitalpin13asoutput
while(true)
{
//====settheledonoroff
arduino.digitalWrite(13,Arduino.HIGH);//settheLED on
Thread.Sleep(1000);//delayaseconds
arduino.digitalWrite(13,Arduino.LOW);//settheLED off
Thread.Sleep(1000);//delayaseconds
}
}
}
}
Test：
1.ClickDebugbuttontoexecute,theLEDwillstartblinking.
DIGITALREAD
ThisexampledetectstheButtonstatethroughdigitalpin(D0-D13).
APIrequired:
1.publicArduino();
2.publicvoidpinMode(intpin,bytemode);
3.publicintdigitalRead(intpin);
HardwareRequired:
1.LattePandax1
2.Buttonx1
3.Resistor(Resistancevaluegreaterthan1KΩ)x1
Circuit: