ORT2/Generator

Generator dijagrama za ORT2 projekat je alat razvijen na SI Wiki za potrebe generisanja dijagrama koji se traže na projektu sa predmeta. Pored toga, alat može da služi kao vizuelni pregled mikroprograma u projektu i može da pronađe određene greške u pojedinačnim koracima.

Način rada

Ukratko, u alat se unose datoteke sa AORSim-kompatibilnim mikrokodom (microProgram.txt) i konfiguracijom (konfiguracija.txt), i alat generiše sve strane dijagrama po formatu traženom na predmetu (ažurno sa formatom dijagrama 2022/2023 godine). Ukoliko želite da štampate vaš dijagram, pritisnite dugme Štampaj (na novoj stranici), podesite format stranice na A4, isključite margine i odštampajte ili sačuvajte u PDF.

Alat je još uvek u testiranju! Ukoliko primetite neke greške ili imate dodatne sugestije o načinu rada generatora, obratite se jednom od razvijača alata. Bez obzira na stabilnost generatora, preporučuje se da nakon generisanja pregledate dijagram da biste videli da li sve ima smisla. To je, uostalom, i smisao ovih dijagrama na projektu.

Detaljnije uputstvo možete pronaći ispod ovog interfejsa.

Uputstvo

Postoje tri odeljka sa opcijama generatora opisana ispod.

Opcije

U ovom odeljku se nalaze opcije koje će studentima najčešće biti potrebne:

• Mikrokod: izabrati microProgram.txt ili bilo koji drugi fajl sa AORSim mikrokodom.
• Konfiguracija: izabrati konfiguracija.txt ili bilo koji drugi fajl sa AORSim konfiguracijom.
• Ime i prezime: ukoliko želite da alat na podnožje svih papira unese vaše ime i prezime, možete uneti ovo polje.
• Broj indeksa: ukoliko želite da alat na podnožje svih papira unese vaš broj indeksa, možete uneti ovo polje.

Nakon popunjavanja ovih polja, možete preći na generisanje dijagrama, ili podešavati napredne opcije.

Akcije

U ovom odeljku možete pokrenuti generisanje:

• Generiši (na ovoj stranici): Generiše pregled dijagrama na trenutnoj stranici. Ova opcija može biti korisna ukoliko želite da brzo pregledate kako izgleda generisani dijagram.
• Štampaj (na novoj stranici): Generiše dijagram na novoj stranici i pokreće dijalog za štampanje. Za optimalno štampanje izabrati A4 format stranice i isključiti margine.
• Preuzmi kao SVG: Preuzima generisani dijagram kao SVG fajl. Ova opcija je uvedena ukoliko želite da napravite modifikacije na dijagram koje nisu moguće kroz opcije generatora, kroz alate poput Inkscape ili Adobe Illustrator.

Ukoliko dođe do greške pri generisanju, u tekstualno polje ispod dugmića za akcije biće ispisane greške. Greške pri parsiranju neće generisati dijagram uopšte, dok će greške u određivanju mikrooperacija dodatno označiti korak sa greškom crvenom bojom.

Napredne opcije

Ukoliko osnovne opcije iznad nisu bile dovoljne, određene aspekte generisanog dijagrama je moguće izmeniti i pomoću naprednih opcija. Nije garantovano da će sve opcije dati smislene rezultate (konkretno opcije za menjanje veličina na dijagramu)

• Širina stranice (sa marginom): Širina jedne stranice u pikselima. Ukoliko dijagram ispadne preširok za štampanje, možete smanjiti ovu veličinu. (Menjanje ove opcije neće promeniti širinu koraka dijagrama, što je veličina čije menjanje nije trenutno dostupno kroz opcije.)
  • Pikseli kao takvi nisu korisna mera za štampanje, već se moraju ručno pretvoriti u inče ili centimetre kako biste odredili kolike veličine su vam zaista potrebne, ali bi podrazumevane veličine u dijagramu trebalo da funkcionišu kako treba.
• Visina stranice (sa marginom): Visina jedne stranice u pikselima. Ukoliko dijagram ispadne previsok za štampanje, možete smanjiti ovu veličinu.
• Naslov leve kolone: Tekst u levoj koloni dijagrama.
• Naslov srednje kolone: Tekst u srednjoj koloni dijagrama.
• Naslov desne kolone: Tekst u desnoj koloni dijagrama.
• Visina strelice: Visina jedne vertikalne strelice između dva koraka.
• Visina zaglavlja: Visina zaglavlja sa naslovima kolona.
• Visina jednog reda podnožja: Visina jednog reda u podnožju dijagrama.
• Margina: Kontroliše količinu beline oko svake strane dijagrama.
• Naziv predmeta: Ukoliko se naziv ORT2 promeni, ili ukoliko nekim čudom ovaj generator bude koristan za druge predmete, možete koristiti ovu opciju da promenite naziv predmeta generisan u podnožju dijagrama.

Budući razvoj

Sledeće ideje za nove funkcionalnosti generatora nisu još uvek implementirane, ali je moguće da će biti u nekoj budućnosti:

1. ETF logo u ćošku dijagrama.
2. IRPOM, IRDA, IRBR i IRJA, pošto nisu pravi registri, bi trebalo da se na dijagramu ispisuju kao odgovarajuće sekvence IR signala, pročitane iz konfiguracije. Ovo je trenutno blokirano time da se redovi sa mikrooperacijama prelamaju samo na zapetama, odnosno jedna mikrooperacija se ne može prelomiti na više redova.
3. GPR[AR] se ispravnije piše GPR[GPRAR]. Ova mogućnost je takođe blokirana boljim prelamanjem teksta.
4. Jedini tekst koji trenutno nije moguće izmeniti jesu oznake polja u podnožju dijagrama.
5. Labele se nikada ne prelamaju, tako da predugački nazivi labela umeju da izađu van svog pravougaonika.
6. Labele koje se nikad ne koriste ili labele koje se samo koriste samo u istom koraku na koji pokazuju mogu biti izbačene iz dijagrama.
7. Skok na korak na istoj strani je preglednije nacrtati kao strelicu koja ide do tog koraka, umesto strelicu do labele.
8. Sve labele se konvertuju u mala slova. Iako naizgled lak za ispravku, ovo je problem do logike parsiranja mikrokoda.
9. Ukoliko generator prijavi grešku u mikrooperaciji, taj korak će biti obojen crvenom bojom. Ukoliko, ipak, generator pogrešno detektuje grešku u mikrooperaciji, treba da postoji mogućnost da korisnik zaobiđe bojenje koraka u crvenu boju u naprednim opcijama.