Supportdokument Maila fil från PLC:n Synpunkter, felaktigheter, önskemål etc. för dokumentet meddelas Fil: Malthe_Suppo_Maila fil.docx
Innehållsförteckning 1. Allmänt... 2 1.1. Programexempel... 2 1.2. Utrustning... 2 2. PG5-projektet... 3 2.1. Device Configurator... 3 3. Skapa fil... 3 4. Skicka mail... 5 5. Filens namn... 8 6. Felsökning... 9 7. Versionshistorik... 10 Malthe Winje Automation AB www.malthe-winje.se Sida 1/10
1. Allmänt Det finns möjlighet att skicka ut filer via mail från PLC:n. I detta dokument går vi genom hur man sätter upp en sådan kommunikation. 1.1. Programexempel Dokumentet hänvisar till programexemplet Project mailafil.zip. 1.2. Utrustning Exemplet är gjort för en PCD3.M5560 med externt minneskort på kortplats M1. Med små ändringar kan exemplet även användas till andra system. Malthe Winje Automation AB www.malthe-winje.se Sida 2/10
2. PG5-projektet Skapa ett PG5-projekt med en fuplafil i. 2.1. Device Configurator I Device Configuratorn behöver PLC:n tilldelas en IP-adress och oftast även en Default Router. 3. Skapa fil I detta exempel mailasen csv-fil ut från PLC:n. Filen som skickas kommer från en HDLog-FBox och kommer få namnet på FBoxen samt datum och tid som namn. Datumet och tiden i filnamnet kommer att maskas ut med hjälp av symboler från HVC-biblioteket. I PG5-projektet behöver man en initieringsbox för HVC, Initialization HVC, samt initieringsbox för minnet som man vill logga till, Memory management. Malthe Winje Automation AB www.malthe-winje.se Sida 3/10
Minnet ska alltid ha Enable hög. Vi vill även att minnet ska kunna komprimeras automatiskt och därför behöver AutoComp vara hög. Sedan behövs en HDLog-box för att skapa filen. FBoxen ställs in för att skapa en csvfil på minnet M1 och FBoxen döps till Loggning. HDLog-FBoxen kan ställas in enligt nedan. FBoxen kommer att skapa en fil varje dag. Filen kommer heta Loggning_DÅÅMMDD.csv. Malthe Winje Automation AB www.malthe-winje.se Sida 4/10
4. Skicka mail I biblioteket Communication Email finns det två olika initierings-fboxar. Då man ska skicka ut en fil behöver man använda FBoxen Adv. Text Mail Initalisation. Det behövs nio stycken textsymboler för att konfigurera FBoxen. SMTP Name Pwd Sender TO1-5 Symbol Förklaring IP-adressen för den SMTP-server som kommer att användas. Användarnamnet till SMTP-servern, används sällan. Lösenord till SMTP-servern, används sällan. Avsändaradress i mailet. Domännamnet (@domän.se) behöver finnas på riktigt men vad som skrivs innan @ är upp till programeraren. Mottagare. Om fler mottagare ska anges separeras de med semikolon. Om man inte behöver något användarnamn och lösenord till SMTP-servern ska man sätta Use authentication till No. Då gör man följande inställning för de textvariabler som används till Name och Pwd på FBoxens framsida. Man behöver skriva in ett IP-nummer till SMTP-servern. Har man bara en adress, till exempel mail.leverantör.nu, kan man pinga servern för att på så sätt få IP-numret. Öppna ditt kommandofönster genom att skriva cmd i sökrutan i din startmeny. I kommandofönstret skriver du sedan ping följt av mellanslag och den adress du har på SMTP-servern. Malthe Winje Automation AB www.malthe-winje.se Sida 5/10
Inställningarna i initierings-fboxen kan oftast lämnas som de är. Mailutskicket är nu initierat. Man behöver en FBox för att bestämma vad som ska skickas. För det används FBoxen Adv. Text Mail Send. FBoxen ska referera till initierings-fboxen. Här krävs tre textvariabler. De två första kommer vara ämnet i mailet respektive texten i själva mailet. De definieras som i exemplet nedan: Den tredje variabeln, File, är sökvägen till den fil som ska skickas. Det som ska skickas är en csv-fil från en HDLog-box. Den kommer alltså få namnet från HDLog- FBoxen samt datum och tid. Alltså kommer filens namn vara olika varje dag. Hur man maskar fram filens namn, och därmed vad som ska stå i textvariabeln för File, förklaras i nästa kapitel. Inuti FBoxen ställer man in mailets prioritet och till vilken mottagare det ska skickas. Mottagaren refererar till de olika grupperna av mottagare som definierades i initieringsboxen för mailutskick. Malthe Winje Automation AB www.malthe-winje.se Sida 6/10
När ingången Send går hög kommer ett mail att skickas. I exemplet skickas mailet en gång om dagen, klockan 06:00. För att konfigurera detta används FBoxen Clock daily pulse. Malthe Winje Automation AB www.malthe-winje.se Sida 7/10
5. Filens namn För att kunna tala om vad filen som ska skickas heter behöver man använda sig av dagens namn och datum. Därför maskas namnet fram enligt nedan. Varje dag 23.00 kommer programmet kolla vad det är för dag, månad och år. Detta kommer att sparas undan i tre register. Innehållet i dessa register används nästa dag för att tala om vad filen som ska skickas heter. Därför blir strängen i variabeln som används till File i FBoxen A Mail Send så här: "M1_FLASH:/webpages/Loggning_D$%02D$",Minne_År.04T,"$",Minne_Månad.04T,"$", Minne_Dag.04T,".csv" M1_FLASH:/webpages Loggning_D Sträng $%02D $",Minne_År.04T" $",Minne_Månad.04T" $",Minne_Dag.04T".csv Förklaring Sökvägen till filen. Filen finns på minnet M1_FLASH och i mappen webpages. Namnet på filen. Kommer av FBoxens namn och att den skapas en fil varje dag. Alla tal ska presenteras med två värdesiffror. Presentera värdet som lagrats i registret Minne_År/Månad/Dag. Tolka registeradressen med fyra siffror. Filändelse Det finns en begränsning på hur långt filnamnet får vara, 23 tecken, därför bör man hålla namnet på HDLog-FBoxen kort. Även datum och ändelse ska ju få plats. Malthe Winje Automation AB www.malthe-winje.se Sida 8/10
6. Felsökning Om utskicket av en fil via mail inte fungerar som man har tänkt sig är det vanligaste att man råkat ut för något av följande fel: IP-numret till SMTP-servern är fel, testa att pinga servern. Inställningarna för textvariablerna Name och Pwd är fel i initierings-fboxen för mailutskicken. Se till att de är satta till fixed size 1 och har två citationstecken som Content. Sökvägen till filen är fel. Man har inte de IP-inställningar som man tror i PLC:n. Gå till debuggern i PG5 och skriv Display SBus för att se att IP-adress och router stämmer. Observera att Saian inte stödjer SSL/TSL-inloggning! Malthe Winje Automation AB www.malthe-winje.se Sida 9/10
7. Versionshistorik Version Kommentar Sign. 2012-07-12 Dokumentet skapades. CH 2013-08-19 Dokumentet uppdaterades. CH 2015-11-19 Dokumentet uppdaterades. CH 2018-04-12 Dokumentet uppdaterades för PG5 2.3. CJ Malthe Winje Automation AB www.malthe-winje.se Sida 10/10