Tehnička dokumentacija. Svrha Vodiča za programera Poruke o greškama Vodič za programera
Ispod je primjer (uzorak) dokumenta " Korisnički vodič“, razvijen na osnovu smjernica RD 50-34.698-90.
Ovaj dokument formira informatičar, ili funkcionalni stručnjak, ili tehnički pisac tokom izrade radne dokumentacije za sistem i njegove dijelove u fazi „Radna dokumentacija“.
Za formiranje korisničkog priručnika, alat je uzet kao primjer Oracle Discoverer informaciono-analitički sistem "Corporate Data Warehouse".
Ispod je sastav korisničkog priručnika u skladu sa GOST-om. Ukratko unutar svakog odjeljka dati su zahtjevi za sadržaj i tekst primjera popunjavanja(naglašeno okomitom linijom).
Odjeljci korisničkog priručnika:
1. Uvod
U odjeljku "Uvod" navedite:
- područje primjene;
- kratak opis mogućnosti;
- nivo obuke korisnika;
- spisak operativne dokumentacije koju korisnik treba da pročita.
1.1. Područje primjene
Zahtjevi ovog dokumenta primjenjuju se kada:
- preliminarna složena ispitivanja;
- probni rad;
- testovi prihvatanja;
- industrijska operacija.
1.2. Kratak opis karakteristika
Informaciono-analitički sistem Corporate Data Warehouse (IAS CCD) je dizajniran da optimizuje tehnologiju za donošenje taktičkih i strateških upravljačkih odluka od strane krajnjih poslovnih korisnika na osnovu informacija o svim aspektima finansijskih i ekonomskih aktivnosti Kompanije.
IAS QCD pruža mogućnost rada sa regulisanim i neregulisanim izveštavanjem.
Prilikom rada sa izvještavanjem koristi se korisnički alat Oracle Discoverer Plus koji pruža sljedeće karakteristike:
- generiranje tabelarnih i unakrsnih izvještaja;
- izrada raznih dijagrama;
- izvoz i uvoz rezultata analiza;
- štampanje rezultata analize;
- diseminacija rezultata analize.
1.3. Nivo korisničkog iskustva
Korisnik QCD IAS-a mora imati iskustvo sa MS Windows (95/98/NT/2000/XP), iskustvo sa Internet Explorerom, softverom Oracle Discoverer, kao i sljedeća znanja:
- poznaju relevantnu predmetnu oblast;
- poznaju osnove multivarijantne analize;
- razumiju višedimenzionalni model relevantne predmetne oblasti;
- poznaju i poseduju veštine u radu sa analitičkim aplikacijama.
Kvalifikacija korisnika treba da omogući:
- generiranje izvještaja u Oracle Discoverer Plus;
- izvrši analizu podataka.
1.4. Spisak operativne dokumentacije koju korisnik treba da pročita
- Informaciono-analitički sistem "Corporate Data Warehouse". PASSPORT;
- Informaciono-analitički sistem "Corporate Data Warehouse". OPŠTI OPIS SISTEMA.
2. Svrha i uslovi korišćenja Oracle Discoverer Plus
U odeljku "Svrha i uslovi upotrebe" navedite:
- vrste aktivnosti, funkcije za čiju je automatizaciju namijenjen ovaj alat za automatizaciju;
- uvjeti, pod (ispunjenjem, nastankom) kojih je korištenje sredstava automatizacije osigurano u skladu sa svrhom (na primjer, vrsta računara i konfiguracija hardvera, operativno okruženje i softver za cijeli sistem, ulazne informacije, podaci nosioci, baza podataka, uslovi za obuku specijalista, itd. P.).
Oracle Discoverer Plus kao deo IAS QCD dizajniran je da automatizuje pripremu, prilagođavanje obrazaca za izveštavanje na osnovu indikatora učinka, kao i za dubinsko istraživanje podataka na osnovu informacija iz korporativnog skladišta podataka.
Rad sa Oracle Discoverer Plus kao dijelom QCD IAS moguć je kad god postoji potreba za dobijanjem informacija za analizu, kontrolu, praćenje i donošenje odluka na osnovu njih.
Rad sa Oracle Discoverer Plus kao dijelom QCD IAS dostupan je svim korisnicima sa postavljenim pravima pristupa.
3. Priprema za rad
U odjeljku "Priprema za rad" navedite:
- sastav i sadržaj distributivnog nosača podataka;
- redoslijed učitavanja podataka i programa;
- postupak provjere rada.
3.1. Sastav i sadržaj distributivnog nosača podataka
Za rad sa IAS QCD neophodan je sledeći softver:
- Internet Explorer (dio Windows operativnog sistema);
- Oracle JInitiator se automatski instalira kada korisnik prvi put pristupi QCD IAS.
3.2. Kako preuzeti podatke i programe
Prije početka rada sa IAS QCD na radnom mjestu korisnika potrebno je preduzeti sljedeće korake:
- Morate otići na web stranicu IAS CCD ias-dwh.ru.
- Tokom preuzimanja, u prozoru "Sigurnosno upozorenje" koji će se pojaviti, koji će sadržavati sljedeće: "Da li želite da instalirate i pokrenete "Oracle JInitiator"..." Kliknite na dugme "Da".
- Tada će početi instalacija Oracle JInitiator-a na vašem računaru. Odaberite dugme Dalje, a zatim OK.
3.3. Procedura zdravstvene provere
Da biste provjerili dostupnost IAS QCD sa radnog mjesta korisnika, morate izvršiti sljedeće korake:
- Otvorite Internet Explorer, za to morate kliknuti na prečicu "Internet Explorer" na radnoj površini ili je pozvati iz menija "Start".
- Unesite adresu: ias-dwh.ru u adresnu traku Internet Explorera i kliknite na "Idi".
- Unesite svoje korisničko ime i lozinku u obrazac za autentifikaciju. Pritisnite dugme "Dalje".
- Provjerite je li aplikacija Oracle Discoverer Plus otvorena u prozoru.
Ako se aplikacija Oracle Discoverer Plus ne pokrene, trebate kontaktirati podršku.
4. Opis operacija
U odjeljku "Opis operacija" navedite:
- opis svih izvršenih funkcija, zadataka, kompleksa zadataka, procedura;
- opis operacija tehnološkog procesa obrade podataka neophodnih za obavljanje funkcija, kompleksa zadataka (zadataka), procedura.
Za svaku operaciju obrade podataka navedite:
- Ime;
- uslovi pod kojima je operacija moguća;
- pripremne radnje;
- glavne radnje u potrebnom redoslijedu;
- završne radnje;
- resurse za operaciju.
4.1. Izvršene funkcije i zadaci
Oracle Discoverer Plus kao dio QCD IAS obavlja funkcije i zadatke navedene u donjoj tabeli:
4.2. Opis operacija toka rada obrade podataka potrebnih za dovršenje zadataka
Ispod je opis korisničkih operacija za obavljanje svakog od zadataka.
Zadatak: "Vizuelizacija izvještaja"
Operacija 1: Registracija na portalu IAS CEA
- Korisnički računar je povezan na korporativnu mrežu.
- IAS QCD portal je dostupan.
- IAS QCD radi u normalnom režimu.
Pripremni koraci:
Na računaru korisnika potrebno je izvršiti dodatna podešavanja navedena u tački 3.2 ovog dokumenta.
- Dvaput kliknite levim tasterom miša na ikonu "IAS QHD" na radnoj površini.
- U prozoru koji se otvori, u polje „Prijava“ unesite korisničko ime, u polje „Lozinka“ unesite lozinku korisnika. Pritisnite dugme "Dalje".
Završni koraci:
Nije potrebno.
15-30 sekundi.
Korak 2: Odabir izvještaja
Uslovi pod kojima je operacija moguća:
Uspješna registracija na IAS CCD Portal.
Pripremni koraci:
Nije potrebno.
Glavne radnje u potrebnom redoslijedu:
1. U prozoru "Čarobnjak za kreiranje radnih knjiga" koji se pojavi, stavite tačku ispred stavke "Otvori postojeću radnu svesku".
2. Odaberite željenu radnu svesku i kliknite na dugme "Otvori":
Završni koraci:
Nakon završetka rada sa izvještajem, izaberite stavku menija „Datoteka“, a zatim izaberite stavku „Zatvori“.
Sredstva utrošena na operaciju:
15 sekundi.
Zadatak: "Formiranje tabelarnih i grafičkih izvještajnih obrazaca"
Popunjeno po analogiji.
5. Hitni slučajevi
U rubrici "Vanredne situacije" naznačiti: 1. radnje u slučaju neispunjavanja uslova za sprovođenje tehnološkog procesa, uključujući i u slučaju dugotrajnih kvarova tehničkih sredstava; 2. radnje za vraćanje programa i/ili podataka u slučaju kvara magnetnog medija ili grešaka u podacima; 3. postupanje u slučajevima otkrivanja neovlašćenog ometanja podataka; 4. postupanje u drugim vanrednim situacijama.
U slučaju grešaka tokom rada IAS QCD, koje nisu opisane u nastavku u ovom odeljku, morate kontaktirati zaposlenog u jedinici tehničke podrške DIT-a (HelpDesk) ili odgovornog administratora IAS QCD.
| Klasa greške | Greška | Opis greške | Potrebna radnja korisnika kada dođe do greške |
|---|---|---|---|
| IAS QCD Portal | Server nije pronađen. Nije moguće prikazati stranicu | Može doći do problema s mrežom ili pristupom IAS QCD portalu. | Da biste riješili probleme s mrežom, kontaktirajte člana odjela tehničke podrške (HelpDesk). U drugim slučajevima, administratoru IAS CCD-a. |
| Greška: potrebno je važeće korisničko ime | Prilikom registracije na portal IAS CCD nije uneseno korisničko ime. | Unesite korisničko ime. | |
| Greška: potrebna je lozinka za registraciju | Prilikom registracije na portal IAS CCD nije unesena lozinka. | Unesite lozinku. | |
| Greška: Autentifikacija nije uspjela. Pokušaj ponovo | Uneseno korisničko ime ili lozinka je netočna, ili račun nije registriran. | Potrebno je ponovo unijeti korisničko ime i lozinku, ali nakon trećeg neuspješnog pokušaja registracije, račun je blokiran. Ako je račun blokiran, potrebno je kontaktirati administratora IAS CEA. | |
| Nestanak struje radne stanice | Radna stanica nema napajanje ili je došlo do nestanka struje. | Radna stanica se isključila ili ponovo pokrenula. | - pritisnite dugme "Start". - odaberite "Pokreni" Ponovo pokušajte povezivanje (prijava) na IAS QCD |
| LAN greška | Ne postoji mrežna interakcija između radne stanice i IAS CCD aplikacijskog servera | Ne postoji mogućnost početka (nastavka) rada sa IAS QCD. Nema mrežne veze sa IAS CCD serverom | Ponovo pokrenite radnu stanicu. Provjerite dostupnost IAS KHD servera na portu 80 izvršavanjem sljedećih naredbi: - pritisnite dugme "Start". - odaberite "Pokreni" - u liniju za unos upišite naredbu telnet ias_dwh.ru 80 - ako se otvori Telnet prozor, onda je veza moguća. Nakon obnavljanja lokalne mreže, pokušajte ponovo da se povežete (prijavite se) na IAS QCD. |
Kovtun M.V. januar 2012
Softver i hardver
brave i zaštite za nivo vode
Programer's Guide
Struktura programa kontrolera
ANOTATION
Ovaj dokument opisuje svrhu, uslove upotrebe i karakteristike aplikativnog softvera (PPO) programabilnog logičkog kontrolera (PLC). Aplikacioni softver industrijskog računara (PC) opisan je u Uputstvu za upotrebu. U ovom dokumentu su po potrebi date veze do PC softvera.
SADRŽAJ
1. SVRHA I USLOVI PRIMJENE PROGRAMA
1.1 Svrha PLC softvera
1.2.Uvjeti za korištenje softverskog PLC-a
2. KARAKTERISTIKE PROGRAMA
2.1. PLC struktura
2.3. Prilagođeni funkcionalni blokovi koji se koriste u softveru Unity
3. KONTAKTIRANJE PROGRAMA
4. ULAZNI I IZLAZNI PODACI
5. PORUKE
1. SVRHA I USLOVI PRIMJENE PROGRAMA
PTS blokada i zaštite nivoa vode u parogeneratorima blokova 1, 2 elektrane je projektovan za zaštitu cevnog sistema parogeneratora pri opadanju nivoa vode, kao i za zaštitu sistema od prodora napojne vode. u strujni put turbine na povećanom nivou u generatoru pare.
Zaštita tehnološkog procesa je obezbeđena kompleksom tehnološke opreme:
Priključci na glavnom dovodu napojne vode (VP-9);
Priključci na glavnom dovodu napojne vode (VP-10);
Priključci na liniji za pročišćavanje (U5-01);
Priključci na liniji za pročišćavanje (U5-02);
Priključci na bajpas liniji napojne vode (VP11);
Komande za uključivanje elektro pumpe za hitne slučajeve (APEN-1);
Komande za uključivanje elektro pumpe za hitne slučajeve (APEN-2);
Komanda za gašenje turbinskog generatora (TG3);
Komanda gašenja turbinskog generatora (TG4);
Izdavanje procesne signalizacije o smanjenju nivoa u 4 od 6 SG
Izdavanje tehnološke signalizacije rada zaštite za +300 mm
Komanda isključivanja regulatora snage na liniji za pročišćavanje +75mm
Naredba za isključivanje regulatora snage na liniji za ispuštanje 500 tona
Izdavanje procesne signalizacije na +125mm
Izdavanje procesne signalizacije na +75mm
Izdavanje procesne signalizacije za ±50mm
Izdavanje tehnološke signalizacije na -120mm
Izdavanje procesne signalizacije za 500t/sat
Funkcionisanje sistema obezbeđuje aplikativni softver (APS).
Aplikacioni softver uključuje industrijski računarski aplikativni softver (aplikacioni softver za računar) i aplikativni softver programabilnog kontrolera (PLC aplikacijski softver).
1.1. Svrha PLC softvera
PLC softver kao dio PTS-a implementira sljedeće funkcije:
– redundantnost kontrolora;
– prijem i obrada ulazno-izlaznih signala iz tri identične ulazno-izlazne korpe;
– Prima i filtrira ulazne diskretne signale od mogućeg „odbijanja“ kontakata.
– Prima i obrađuje analogne ulazne signale:
omogućava kontrolu izlaznog signala izvan dozvoljenih granica (nepouzdanost signala);
vrši skaliranje analognog signala;
vrši histerezu graničnih vrijednosti;
analizira stanja tri signala iz sastava korpi i odabir pouzdanih vrijednosti;
vrši filtriranje signala po stopi povećanja ili smanjenja vrijednosti signala.
– Izdavanje diskretnih signala opremi (aktivacija zaštite);
– Kontrola odstupanja parametara od zadataka i postizanje zadatih vrijednosti;
- Izdavanje izvršnih radnji na procesne signalne lampe u kontrolnoj sobi;
– Implementacija algoritama zaštite i blokiranja;
– Razmjena podataka sa susjednim sistemima preko Modbus/TCP/IP kanala;
- Provjera grešaka u modulima kontrolera, te generiranje poruka za radnu stanicu o stanju opreme kontrolera, kao i za centralu;
– Praćenje vanrednih situacija opreme sistema;
- PLC softver pruža mogućnost primanja sa industrijskog računara, kao i sa kontrolne table, ključeva koji onemogućavaju određene zaštite i blokiraju sistem.
1.2. Uvjeti za korištenje PLC softvera
Opšta arhitektura sistema prikazana je na slici 1.
Slika 1. Opća arhitektura aplikativnog softvera
PTS kompleks uključuje sljedeće hardverske i kupljene softverske komponente:
1) Dva QUANTUM programabilna logička kontrolera (PLC) zasnovana na P266 CPU-u koja rade u režimu vruće pripravnosti. Runtime Unity Pro 4.1 XL.
2) Industrijski računar koji se sastoji od:
– personalni računar (ugrađeni industrijski računar);
– operativni sistem Windows XP Pro SP3;
– CITECT 7 paket za vizualizaciju
PLC-ovi komuniciraju sa eksternim podsistemima preko Ethernet mreže (sa strane PLC-a) i preko I/O kanala.
Interakcija između PLC-a i industrijskog računara se odvija preko Ethernet mreže.
TCP uključuje komponente aplikativnog softvera razvijene u skladu sa ovim projektom:
Unity Pro aplikacija instalirana na PLC-u.
Citect aplikacija instalirana na računaru.
2. KARAKTERISTIKE PROGRAMA
2.1. PLC struktura
PLC aplikativni softver je implementiran kao aplikacija (vidi sliku 1) napisana u okruženju Unity v.4.1. Naziv aplikacije je upg.stu.
Upg.stu aplikacija omogućava implementaciju funkcionalnosti sistema implementiranog na PLC-u za sve načine rada.
Aplikacija sadrži:
konfiguracija hardvera i softvera;
skup funkcionalnih modula, od kojih je svaki implementiran sekcijama napisanim na jeziku LD (ljestvičasti dijagram);
skup funkcionalnih blokova razvijenih u okviru projekta;
baza podataka;
animacijske tabele.
Aplikacija uključuje sljedeće funkcionalne module, od kojih svaki sadrži jedan ili više programskih modula, kao što je prikazano u tabeli 1.
Tabela 1
Init Sekcija se izvršava u prvom ciklusu nakon pokretanja i osigurava da su svi parametri inicijalizirani.
AI_to_AM Sekcija za obradu analognog ulaznog signala. Odgovarajući signalni blok se poziva da dodijeli vrijednost internoj varijabli i provjeri valjanost kanala.
DI_to_DM Sekcija za obradu ulaznih diskretnih varijabli. Funkcijski blok odgovarajućeg signala se poziva da dodijeli vrijednost internoj varijabli i provjeri valjanost kanala.
Odeljak za poređenje za poređenje primljenih vrednosti iz tri različita distribuirana I/O binca. Signali se upoređuju prema logici 2 od 3. Ako su dva signala identična, a treći različit, onda se potonji poništava.
Naziv odjeljka Funkcionalnost
Alarmi Odjeljak za obradu digitalnog i analognog signala za određivanje da li su dostignute granične vrijednosti. Izrada alarma i komandi za izvođenje blokada i zaštita.
INTERLOCK Sekcija formiranja algoritma blokiranja i zaštite. Ovaj odjeljak piše u varijable povezane s aktuatorima.
SIM Sekcija za upravljanje simulacionim i testnim modovima kontrolera.
DIJAGNOSTIKA Odjeljak za generiranje dijagnostičkih informacija kontrolera.
Unutar sekcija se koriste sljedeće potprograme:
tabela 2
Naziv odjeljka Funkcionalnost
CompAI Funkcijski blok dizajniran za upoređivanje tri različite analogne vrijednosti, izlaz rezultujuće vrijednosti, kao i dijagnostičke informacije za svaki od kanala.
CompDI Funkcijski blok dizajniran za upoređivanje tri diskretna signala koji dolaze iz tri različite korpe, izlaz rezultujuće vrijednosti, kao i dijagnostičke informacije za svaki od kanala.
BlockF Funkcijski blok dizajniran za otkrivanje neprihvatljivo brzog pada ili porasta analogne vrijednosti. U slučaju prekida ili kratkog spoja, ovaj FB će ukloniti ovaj signal iz obrade, što neće dozvoliti zaustavljanje procesa.
GetDI Funkcijski blok dizajniran za primanje i obradu diskretnih signala. Vrši filtriranje "odbijanja" kontakata.
Naziv odjeljka Funkcionalnost
HLLA4 Funkcijski blok dizajniran da generiše četiri kršenja praga iz jednog analognog signala (HH, H, L, LL). FB uzima u obzir parametre histereze i mrtve zone za otklanjanje kršenja.
GetAI Funkcijski blok dizajniran za primanje i obradu analognih signala. Izvodi skaliranje vrijednosti, a također obavlja funkcije djelomične izravnavanja.
SIMPMEHA Funkcijski blok za izlaz sinusoidnog šuma. Ova smetnja se "miješa" u simulirani signal kako bi mu se dala realizam kada se radi s načinima kao što je "uzorkovanje".
SIMPULSE Funkcijski blok za izdavanje impulsa određenog trajanja u sistemu.
SIMPV Funkcijski blok dizajniran da simulira analognu vrijednost pri radu u načinima kao što je "uzorkovanje".
2.2. PLC strukture podataka
Ukupno ima šest generatora pare u svakoj elektrani, a programski elementi softvera su identični za svaki od njih.
Softverski projekat kontrolera koristi sljedeće tipove podataka:
Statusna riječ analognog kanala – tip riječi;
Riječ statusa diskretnog kanala – tip riječi;
Riječ koja definira vrijednost analognog kanala je pravog tipa (reči od dvije riječi);
Statusna riječ QUANTUM kontrolera je tip riječi (dvije riječi su rezervirane ukupno);
Riječ stanja kršenja – vrsta riječi;
Riječ stanja zaključavanja je tip riječi;
Statusna riječ deblokiranja ključeva – vrsta riječi;
Industrijski kompjuter dozvoljava samo kontrolu ključeva za otpuštanje promjenom stanja bitova preko kontrolne riječi. PLC prijavljuje svoj status preko statusne riječi. Opis pojedinačnih polja (bitova) reči podataka dat je u Uputstvu za programere.
Varijable u PLC-u su kodirane na sljedeći način:
AI - analogni ulaz za PLC;
AIM – PLC/PC interni analogni ulaz;
DI – diskretni ulaz u PLC;
DM – PLC/PC interni diskretni ulaz;
2.3. Prilagođeni funkcionalni blokovi koji se koriste u softveru Unity
2.3.1 Funkcijski blok za usporedbu analognih kanala CompAI
.
Slika 2 CompAI analogni funkcionalni blok za poređenje kanala
Ovaj FB se koristi za poređenje tri različite analogne vrijednosti. Ako jedan od analognih parametara prelazi prosječnu vrijednost druga dva, tada se njegova vrijednost ne uzima u obzir i poruka o grešci se upisuje u svojstvo ovog kanala. Ako su sva tri kanala dobra (unutar prihvatljive tolerancije neusklađenosti), onda će rezultat biti veća od postojećih vrijednosti.
2.3.2 Funkcijski blok za poređenje analognih kanala CompDI
Slika 3. Funkcijski blok za poređenje diskretnih kanala CompDI
Ovaj FB se koristi za poređenje tri para diskretnih signala. Ako su dvije vrijednosti u paru signala iste, to će značiti prekid ili kratki spoj. U ovom slučaju, ovaj par se ne uzima u obzir i povlači se iz prometa. Sistem izdaje poruku o prirodi kršenja koja ga je izazvala. Ako se ukupna vrijednost u tri različita para razlikuje, tada blok algoritam poništava one koji se ne podudaraju s prethodna dva.
2.3.3 Funkcijski blok za izračunavanje brzine pada analogne vrijednosti BlockF
Slika 4. Funkcijski blok za izračunavanje brzine pada analogne vrijednosti BlockF
Ovaj FB se koristi za izračunavanje brzine porasta i pada vrijednosti na analognim kanalima. Ako dođe do prekida žice na analognom senzoru ili oštrog pada fizičke vrijednosti, tada će parametar očitan s ovog senzora početi naglo opadati. Ovaj FB je dizajniran da uhvati događaje o kratkom spoju ili prekidu i upiše znak greške u statusnu riječ kanala. To jest, ako dođe do prekida ili kratkog spoja, ovaj kanal će biti povučen iz cirkulacije.
2.3.4 Funkcijski blok za skaliranje analognog kanala GetAI
Slika 5. Funkcijski blok za skaliranje analogne veze GetAI
Ovaj FB se koristi za pretvaranje programskih jedinica kontrolera (INT) u vrijednosti stvarnih jedinica tehnološkog procesa (REAL). Ako parametar prelazi granice dozvoljene greške (OFFSET), na kanalu se ne generira greška i parametar se zaustavlja na maksimalnoj ili minimalnoj vrijednosti. Ako se parametar ističe više od normalizirane greške, tada se na kanalu generiše greška s dekodiranjem prirode kršenja.
2.3.5 Funkcijski blok za obradu diskretnog kanala GetDI
Slika 6. Funkcijski blok za obradu diskretnog kanala GetDI
Ovaj FB se koristi za filtriranje "odbijanja" na diskretnom kanalu. U slučaju gubitka komunikacije sa kanalom, navedena vrijednost se upisuje na ulaz ovog FB-a, zbog čega će se zadana vrijednost upisati na rezultirajući izlaz na izlazu funkcionalnog bloka.
2.3.6 Funkcijski blok za generiranje praga HLLA4
Slika 7. Funkcijski blok za generiranje praga HLLA4
Ovaj FB se koristi za implementaciju četiri prekršaja praga, koji se mogu koristiti i za izdavanje sistemskih povreda i za njihovu implementaciju u algoritme za implementaciju blokiranja i zaštite. Kako povreda ne bi odmah nestala kada se vrati područje zadane vrijednosti, predviđena je funkcija histereze koja utječe na prirodu izlaza signala o kršenju.
2.3.7 Funkcijski blok za generiranje sinusoidnog šuma SIMPMEHA
Slika 8. Funkcijski blok za generiranje sinusoidnog šuma SIMPMEHA
Ovaj FB se koristi za implementaciju režima kontrolera koji su povezani sa otklanjanjem grešaka i simulacijom rada instalacije. Ovaj signal na dijagramu izgleda kao sinusoidna kriva, sa rasponom širenja zadanim granicama (ulaznim varijablama). Ova smetnja je dizajnirana da se "pomiješa" sa veličinom analognog signala i da mu da dinamička svojstva i vizualni realizam.
2.3.8 Funkcijski blok za generiranje impulsa SIMPULSE
Slika 9. Funkcijski blok za generiranje impulsa zadane dužine SIMPULSE
Ovaj FB se koristi za implementaciju režima kontrolera koji su povezani sa otklanjanjem grešaka i simulacijom rada instalacije. Ovaj signal na dijagramu izgleda kao meandar, sa različitim rasponima vrhova i dna. Vremenske vrijednosti vrhova meandra date su vremenskim ograničenjima (ulaznim varijablama).
2.3.9 Funkcijski blok za generiranje analogne varijable SIMPV
Slika 10. Funkcijski blok za generiranje analogne varijable SIMPV
Ovaj FB se koristi za generiranje analognih signala za modove simulacije rada uređaja i otklanjanja grešaka u kontroleru.
3. KONTAKTIRANJE PROGRAMA
Program na licu mesta je konfigurisan tako da se automatski pokreće kada se kontroler uključi. Status programa se prikazuje na displeju kontrolera. Postavke programa se mogu konfigurisati sa prenosivog računara koji je uključen u isporuku sistema.
4. ULAZNI I IZLAZNI PODACI
Ulazni podaci sistema su informacije koje od upravljačkog objekta dolaze do PTS-a preko komunikacionih uređaja sa objektom (distribuirane periferije), kao i komande koje operater unosi sa računara.
Izlaz sistema je informacija koja se prenosi do upravljačkog objekta od PTS-a preko komunikacijskog uređaja sa objektom. Informacije se prikazuju u PC-u u obliku ekranskih obrazaca i unose u obliku alarma na centralu kontrolne sobe.
5. PORUKE
Poruke koje se prenose preko PLC-PC sučelja opisane su u Vodiču za programere. Dio 2. PLC-PC sučelje. Poruke koje se izdaju operateru opisane su u dokumentu "Vodič za operatera".
#Manual, #programer, #description, #PLC, #PTS, #interface, #analog, #controller
Napravljeno 02.02.2010 09:34:31
Svrha i uslovi korišćenja programa
U odeljku "Svrha i uslovi korišćenja programa" treba navesti svrhu i uslove neophodne za implementaciju programa (obim, sastav i parametri, zahtevi za itd.) [iz tačke 2.1 GOST 19.504-79]
Karakteristike programa
Odjeljak "Karakteristike programa" treba da sadrži opis glavnih karakteristika i karakteristika programa (privremene karakteristike, način rada, sredstva praćenja izvršavanja i samooporavljanja programa, itd.) [iz tačke 2.2. GOST 19.504-79]
Apel na program
Odeljak "Pristup programu" treba da sadrži opis procedura za pozivanje programa (metode za prenos parametara kontrole i podataka, itd.) [iz tačke 2.3 GOST 19.504-79]
Ulazni i izlazni podaci
U odjeljku "Ulazni i izlazni podaci" treba dati opis organizacije korištenih ulaznih i izlaznih informacija i, ako je potrebno, [iz klauzule 2.4 GOST 19.504-79]
Poruke
Odeljak "Poruke" treba da sadrži tekstove poruka koje se izdaju programeru ili tokom izvršavanja programa, opis njihovog sadržaja i radnje koje treba preduzeti na tim porukama [iz tačke 2.5 GOST 19.504-79]
Prijave
Dodatni materijali (primjeri, ilustracije, tabele, grafikoni, itd.) mogu se dati u dodatku priručniku programera [iz klauzule 2.6 GOST 19.504-79]
Uputstvo za upotrebu sastavljeno je na osnovu GOST 19.504-79. Programerski vodič je razvijen u tri slučaja:
- softverski proizvod u svojoj osnovnoj nameni je razvojno okruženje ili biblioteka (kao Delphi ili Qt);
- kompleksni ili softverski proizvod služi kao platforma za razvoj programa ili sistema određenog tipa (poput 1C ili Axapta);
- program se distribuira zajedno sa izvornim kodom ili ga sami programeri stalno modificiraju.
Očigledan zadatak vodiča za programere je da programeru pruži informacije koje će mu biti dovoljne da kreira sopstvene programe ili sisteme zasnovane na razvijenom softverskom proizvodu.
Vodič za programere treba da objasni:
– S kojim objektima se programer bavi, gdje se nalaze, koliko dugo postoje i kako međusobno djeluju. Koje od njih sam kreira, a koje mu inicijalno pružaju okruženje, okvir, biblioteka.
– Koji drugi razvojni alati (osim razvijenog softverskog proizvoda) su potrebni da bi se kreirala aplikacija ili sistem. Na primjer, ako je razvijeni softverski proizvod biblioteka, programeru će biti potreban kompajler, neka vrsta razvojnog okruženja i drugi alati.
– U kom okruženju aplikacija ili sistem radi. Koji će biti njegovi minimalni sistemski zahtjevi. Da li će mu biti potrebni dodatni softverski alati za njegovo pokretanje: okviri, vrijeme izvođenja, interpretatori.
– Koja je minimalna zdrava aplikacija ili minimalno zdrav sistem. Koje objekte treba kreirati i kojim redoslijedom, kako ih međusobno povezati kako bi aplikacija mogla izvesti neki minimalni izlaz.
– Kako (korak po korak) sastaviti radnu aplikaciju ili implementirati radni sistem.
Osim toga, priručnik programera mora sadržavati potpune opise svih objekata predviđenih softverskim proizvodom. Ako su funkcije, onda treba dati njihov sinopsis, ako su klase, onda opise njihovih interfejsa, itd.
Ako softverski proizvod koristi originalni programski jezik i ima svoj kompajler ili interpreter, njegov opis mora biti uključen u priručnik za programera.
U tekstu priručnika se moraju poštovati sljedeća pravila:
– Prilikom uvođenja novog pojma treba se osloniti samo na one pojmove koji su ranije uvedeni ili su poznati čitaocu.
– Unos svakog koncepta mora biti nečim opravdan.
Glavni zahtjev u opisu pojedinačnih objekata je potpunost opisa svakog od njih.
Prilikom opisivanja objekata posebnu pažnju treba obratiti na sljedeće aspekte:
– Šta mora nužno prethoditi stvaranju i upotrebi objekta.
– Koje su nuspojave pristupa objektu.
– Osobitosti interpretacije od strane objekta podataka koji mu se prenose.
– Gdje se “fizički” (u kojoj datoteci, u kojoj biblioteci) nalazi objekt.
– Preporučljivo je dati primjere korištenja za svaki objekt, male fragmente koda koji demonstriraju stvaranje objekta (ako ga je potrebno kreirati prije upotrebe), prijenos ulaznih podataka u objekt, prijem izlaznih podataka i njihovo interpretacija.
Moguće je izvršiti programerov ručni hipertekst.
Struktura vodiča za programera:
1. Svrha i uslovi za primjenu programa.
2. Karakteristike programa.
3. Žalba na program.
4. Ulazni i izlazni podaci.
5. Poruke.
Vodič za programera može biti upotpunjen raznim dijagramima, na primjer, dijagramima baze podataka, dijagramima klasa, grafovima poziva.
Kao primjer, sadržaj priručnika programera System e-port dealer. Protokol klijent-server.
Sistem "e-port dealer" je namenjen za primanje i vršenje instant plaćanja prilikom plaćanja usluga mobilnih komunikacija, pristupa Internetu itd. Centralni server sistema pripada grupi e-port i svako može otvoriti punkt za primanje plaćanja. instaliranjem računarskog (povezanog na Internet) klijentskog programa. Razmjena podataka između centralnog servera i klijentskog programa odvija se prema posebnom protokolu. Protokol je otvoren, što omogućava raznim organizacijama: bankama, maloprodajnim lancima, mrežama platnih terminala da vrše plaćanja direktno iz sopstvenih sistema. Protokol je razvila e-port Group, a tehničku dokumentaciju je naručio Philosoft.
UVOD
e-port diler sistem: klijent-server protokol. Svrha i pregled karakteristika
Protokolarni zadaci
Glavne prednosti korištenja protokola
1 implementacija protokola (gateway)
1.1 Opće informacije
1.2 Struktura aplikacije
2. Kako funkcioniše gateway
2.1 Registracija i izvještavanje
2.1.1 Registracija
2.1.2 Izvještavanje
2.2 Komunikacija sa serverom
2.2.1 Struktura paketa
2.2.2 Imenici
2.2.3 Nalog za razmjenu paketa
2.3 Ciklus obrade operacije
2.3.2 Red čekanja
2.3.3 Analiza odgovora servera
2.3.4 Nestandardne situacije
3 Specifikacija protokola
3.1 Strukturni elementi paketa
3.2 Zaglavlje zahtjeva
3.3 Zaglavlje odgovora
3.4 Dopuna računa
3.5 Kupovina PIN-a
3.6 Prekid obrade operacije
3.7 Transakciona svojstva operacije
3.9 Imenik
3.11 Status rada
3.11.1 Primjeri poruka o statusu rada
3.11.2 Statusni kodovi za transakcije na čekanju ili dovršene transakcije
3.11 Sistemska obavještenja
4 GLOSAR
APPS
Dodatak 1. XML upit DTD i komentar
Ako, osim korištenja i prilagođavanja, softver pruža mogućnost pisanja, uređivanja ili korištenja programskog koda. Koji dokument je potreban u ovom slučaju?
Svrha Vodiča za programera
Programerski priručnik se odnosi na operativnu i tehničku dokumentaciju i potreban je u slučajevima kada sistem na ovaj ili onaj način pruža mogućnost pisanja, uređivanja ili korištenja programskog koda.
Primjeri su:
– biblioteka funkcija;
– platforma ili okruženje za razvoj softvera;
- Softver otvorenog koda.
Dokument treba da pruži sve potrebne informacije kako bi programer mogao iskoristiti mogućnosti sistema. Da bi se riješio ovaj problem, sadržaj dokumenta može uključivati:
– svrha, struktura ulaznih i izlaznih podataka programskih funkcija;
– mogućnosti kreiranja programskog koda, karakteristike njegove interpretacije i kompilacije;
– sintaktičke karakteristike korišćenog programskog jezika;
– moguća pravila i ograničenja u radu sa programskim kodom;
- razne upute za rad sa programom.
Lista mogućih tema nije ograničena na ovo, sve zavisi od karakteristika određenog sistema. Moram reći da vodič za programere može biti vrlo koristan za programere sistema, budući da je vodič za trenutnu implementaciju softverske logike.
Sastav tipičnog vodiča za programere
U skladu sa zahtjevima GOST-a, priručnik programera trebao bi sadržavati sljedeće odjeljke:
– Svrha i uslovi za primjenu programa, gdje su naznačeni obim softvera i tehnički zahtjevi potrebni za njegov rad.
– Karakteristike programa, gdje opisuju način rada programa, indikatore njegove brzine i druge važne karakteristike za korištenje.
– Apel na program, gdje ukazuju na metode i parametre za pokretanje programa;
– Ulazni i izlazni podaci, gdje opisuju format, način organizacije i druge zahtjeve za ulazne i izlazne podatke;
– Poruke, gdje su dati tekstovi poruka koje program izdaje u različitim situacijama i radnje koje treba poduzeti u tom slučaju.
Preporučljivo je navesti različite primjere, ilustracije i tabele u prilozima uz dokument.
Standardi za vodič za programere
GOST-ovi također reguliraju ovaj dokument, u ovom slučaju to je GOST 19.504. U skladu sa njim utvrđuje se struktura i sadržaj Vodiča za programere.
Troškovi izrade vodiča za programere
Posao kreiranja vodiča za programere zahtijeva visokokvalificiranog stručnjaka i znanja iz područja programiranja, međutim, za profesionalne programere takav posao obično izgleda dosadno i zamorno, štoviše, zahtijeva sposobnost pravilnog formuliranja i komuniciranja materijala na pristupačan način. . Stručnjaci TechRightConsult-a imaju veliko iskustvo u obje oblasti, što nam omogućava da kreiramo dokumente po pristupačnoj cijeni i na vrijeme!
