EM400 - konfiguracja - Historia wersji

Amo o 17:22, 1 gru 2021

2021-12-01T17:22:06Z

← poprzednia wersja		Wersja z 17:22, 1 gru 2021
Linia 1:		Linia 1:
	Plik konfiguracyjny EM400 pozwala skonfigurować parametry sprzętowe emulowanej maszyny i jest wymagany do uruchomienia emulatora. Jeśli użytkownik podał nazwę pliku konfiguracyjnego w linii poleceń (używając przełącznika '''-c'''), zostanie on użyty. Jeśli nie, domyślnie używany jest plik '''~/.em400/em400.ini'''.		Plik konfiguracyjny EM400 pozwala skonfigurować parametry sprzętowe emulowanej maszyny i jest wymagany do uruchomienia emulatora. Jeśli użytkownik podał nazwę pliku konfiguracyjnego w linii poleceń (używając przełącznika '''-c'''), zostanie on użyty. Jeśli nie, domyślnie używany jest plik '''~/.em400/em400.ini'''.

	= Składnia pliku ~~konfiguracyjnego =~~		Składnia pliku i opis poszczególnych opcji znajduje się [https://github.com/jakubfi/em400/blob/master/cfg/em400.ini.template tutaj]

	~~Konfiguracja składa~~ się ~~z sekcji opisujących poszczególne elementy systemu. Definicja sekcji rozpoczyna się jego nazwą, po czym występują opcje konfiguracji dla danej sekcji. Rozpoznawane są następujące sekcje:~~

	* '''cpu''' - konfiguracja emulacji procesora
	* '''memory''' - konfiguracja emulacji pamięci
	* '''log''' - konfiguracja logowania
	* '''ui''' - ustawienia interfejsu użytkownika
	* '''sound''' - konfiguracja dźwięku
	* '''fpga''' - konfiguracja połączenia ze sprzętową implementacją procesora
	* '''io''' - konfiguracja kanałów I/O systemu
	* '''devX.Y''' - konfiguracja urządzeń w kanałach, gdzie X jest numerem kanału, a Y numerem urządzenia

	~~== CPU ==~~

	~~Dostępne sa następujące opcje konfigurujące działanie procesora~~:

	* '''fpga''' - używanie sprzętowej implementacji procesora (true/~~false)~~
	* '''speed_real''' - zachowanie prędkości emulacji odpowiadającej prawdziwej MERZE-400 (true/~~false)~~.
	* '''speed_factor''' - współczynnik prędkości emulacji
	* '''throttle_granularity''' - kwant czasu (w mikrosekundach) używany do śledzenia prędkości emulacji
	* '''clock_period''' - okres [[Przerwanie_zegarowe\|zegara systemowego]] (w milisekundach)
	* '''clock_start''' - uruchom zegar systemowy przy starcie emulatora (true/~~false)~~
	* '''modifications''' - włącz modyfikacje procesora do zgodności z MX-16 (true/~~false)~~
	* '''user_io_illegal''' - instrukcje IN/~~OU nielegalne dla programów użytkownika (true~~/~~false)~~
	* '''awp''' - dołącz [[Arytmometr Wielokrotnej Precyzji]] (true/~~false)~~
	* '''stop_on_nomem''' - procesor przechodzi w stan STOP przy odwołaniu to nieskonfigurowanego segmentu pamięci w bloku 0 (true/~~false)~~
	* '''kb''' - wartość do ustawienia na kluczach pulpitu technicznego przy starcie emulatora

	~~Przykładowy blok konfiguracji procesora:~~

	~~[cpu]~~
	~~fpga = false~~
	~~speed_real = false~~
	~~speed_factor = 1~~
	~~throttle_granularity = 10~~
	~~clock_period = 10~~
	~~clock_start = true~~
	~~stop_on_nomem = true~~
	~~user_io_illegal = true~~
	~~awp = true~~
	~~modifications = false~~
	~~kb = 0~~

	~~== Pamięć ==~~

	* '''elwro_modules''' - ilość bloków pamięci Elwro (bloki 32ksłowa)
	* '''mega_modules''' - ilość bloków [[Pamięć MEGA\|pamięci MEGA]] (bloki 64ksłowa)
	* '''mega_prom''' - nazwa pliku z obrazem pamięci PROM MEGA
	* '''mega_boot''' - boot systemu z pamięci MEGA (true/false)
	* '''hardwired_segments''' - liczba segmentów zarezerwowanych dla systemu operacyjnego (1 lub 2)
	* '''preload''' - program ładowany do bloku 0 pamięci przy starcie emulatora

	~~Przykładowy blok konfiguracji pamięci:~~

	~~[memory]~~
	~~elwro_modules = 1~~
	~~mega_modules = 0~~
	~~hardwired_segments = 2~~
	~~mega_prom = mega0.bin~~
	~~mega_boot = false~~
	~~preload = program.bin~~

	~~== Logowanie ==~~

	~~EM400 pozwala na logowanie zdarzeń do pliku. Zadrzenia występują w obrębie ''komponentów''. Lista dostępnych komponentów jest następująca:~~
	* em4h - emulator
	* reg, mem, cpu, op, int - rejestry, pamieć, procesor i wykonywane instrukcje, przerwania
	* io, mx, px, cchr, cmem - wejście/wyjście i kanały
	* term, wnch, 9045, flop, pnch, pnrd - urządzenia zewnętrzne
	* crk5 - CROOK-5
	* all - komponent specjalny, zawiera wszystkie pozostałe komponenty

	~~Konfiguracja logowania obejmuje następujące opcje:~~

	* '''enabled''' - aktywuj logowanie (true/false)
	* '''file''' - plik, do którego zapisywany będzie log
	* '''components''' - określa które komponenty będą logowane
	* '''line_buffered''' - pozwala włączyć buforowanie linii

	~~Przykładowy blok konfiguracji logowania:~~

	~~[log]~~
	~~enabled=true~~
	~~file=~~em400.~~log~~
	~~components=em4h~~
	~~line_buffered=true~~

	~~== Urządzenia zewnętrzne ==~~

	~~=== Kanały ===~~

	~~Dołączenie emulacji kanału wymaga podania w sekcji '''io'' nazw kanałów jako wartości dla kluczy '''channel_X''', gdzie X jest numerem kanału, np~~.:

	~~[io~~]
	~~channel_15 = char~~

	~~=== Urządzenia ===~~

	~~Konfiguracja emulowanych urządzeń definiowana jest w osobnych sekcjach nazwanych '''devX.Y''', gdzie X jest numerem kanału, a Y numerem urządzenia.~~

Amo o 17:20, 1 gru 2021

2021-12-01T17:20:36Z

Podgląd zmian

Amo: /* Logowanie */

2021-12-01T16:59:17Z

Logowanie

← poprzednia wersja		Wersja z 16:59, 1 gru 2021
Linia 44:		Linia 44:
	== Logowanie ==		== Logowanie ==

	EM400 pozwala na logowanie zdarzeń do pliku. Zadrzenia występują w obrębie ''komponentów'' ~~i na ''poziomach'' logowania~~. ~~Poziom logowania jest liczbą od 0-9, a lista~~ dostępnych komponentów jest następująca:		EM400 pozwala na logowanie zdarzeń do pliku. Zadrzenia występują w obrębie ''komponentów''. Lista dostępnych komponentów jest następująca:
	* em4h - emulator		* em4h - emulator
	* reg, mem, cpu, op, int - rejestry, pamieć, procesor i wykonywane instrukcje, przerwania		* reg, mem, cpu, op, int - rejestry, pamieć, procesor i wykonywane instrukcje, przerwania
Linia 56:		Linia 56:
	* '''enabled''' - aktywuj logowanie (true/false)		* '''enabled''' - aktywuj logowanie (true/false)
	* '''file''' - plik, do którego zapisywany będzie log		* '''file''' - plik, do którego zapisywany będzie log
	* '''~~levels~~''' - ~~poziomy logowania opisane w składni:~~ '''~~komponent=poziom[,komponent=poziom[,...]]~~'''~~. Ustawione poziomy mówią jakie zdarzenia (do jakiego poziomu w danym komponencie) będą logowane.~~		* '''components''' - określa które komponenty będą logowane
			* '''line_buffered''' - pozwala włączyć buforowanie linii

	Przykładowy blok konfiguracji logowania:		Przykładowy blok konfiguracji logowania:

	~~emulog {~~		[log]
	enabled = true		enabled=true
	~~levels~~ = ~~"all~~=1,em4h~~=2,wnch=10"~~		file=em400.log
	}		components=em4h
			line_buffered=true

	== Urządzenia zewnętrzne ==		== Urządzenia zewnętrzne ==

Amo: /* Logowanie */

2015-01-27T03:28:09Z

Logowanie

← poprzednia wersja		Wersja z 03:28, 27 sty 2015
Linia 57:		Linia 57:
	* '''file''' - plik, do którego zapisywany będzie log		* '''file''' - plik, do którego zapisywany będzie log
	* '''levels''' - poziomy logowania opisane w składni: '''komponent=poziom[,komponent=poziom[,...]]'''. Ustawione poziomy mówią jakie zdarzenia (do jakiego poziomu w danym komponencie) będą logowane.		* '''levels''' - poziomy logowania opisane w składni: '''komponent=poziom[,komponent=poziom[,...]]'''. Ustawione poziomy mówią jakie zdarzenia (do jakiego poziomu w danym komponencie) będą logowane.
	* '''pname_offset''' - opcja ma znaczenie, jeśli w emulatorze uruchamiany jest system CROOK-5. Jej użycie powoduje, że dla każdego zdarzenia generowanego w procesorze, będzie logowana nazwa procesu, w którego kontekście znajduje się system operacyjny. W zależności od wersji jądra systemu przesunięcie nazwy procesu jest inne: dla jąder w wersji "N" wynosi 52, a dla wersji "P" - 54. Logowanie nazwy procesu nie jest w 100% precyzyjne, ponieważ jest ona aktualizowana tylko przy wywołaniach instrukcji LIP i SP.

	Przykładowy blok konfiguracji logowania:		Przykładowy blok konfiguracji logowania:
Linia 64:		Linia 63:
	enabled = true		enabled = true
	levels = "all=1,em4h=2,wnch=10"		levels = "all=1,em4h=2,wnch=10"
	~~pname_offset = 54~~
	}		}

Amo: /* Logowanie */

2014-11-10T22:28:57Z

Logowanie

← poprzednia wersja		Wersja z 22:28, 10 lis 2014
Linia 45:		Linia 45:

	EM400 pozwala na logowanie zdarzeń do pliku. Zadrzenia występują w obrębie ''komponentów'' i na ''poziomach'' logowania. Poziom logowania jest liczbą od 0-9, a lista dostępnych komponentów jest następująca:		EM400 pozwala na logowanie zdarzeń do pliku. Zadrzenia występują w obrębie ''komponentów'' i na ''poziomach'' logowania. Poziom logowania jest liczbą od 0-9, a lista dostępnych komponentów jest następująca:
			* em4h - emulator
	* reg, mem, cpu, op, int - rejestry, pamieć, procesor i wykonywane instrukcje, przerwania		* reg, mem, cpu, op, int - rejestry, pamieć, procesor i wykonywane instrukcje, przerwania
	* io, mx, px, cchr, cmem - wejście/wyjście i kanały		* io, mx, px, cchr, cmem - wejście/wyjście i kanały
	* term, wnch, 9045, flop, pnch, pnrd - urządzenia zewnętrzne		* term, wnch, 9045, flop, pnch, pnrd - urządzenia zewnętrzne
	* em4h - emulator
	* crk5 - CROOK-5		* crk5 - CROOK-5
	* all - komponent specjalny, zawiera wszystkie pozostałe komponenty		* all - komponent specjalny, zawiera wszystkie pozostałe komponenty

Amo: /* Logowanie */

2014-11-10T22:28:05Z

Logowanie

← poprzednia wersja		Wersja z 22:28, 10 lis 2014
Linia 48:		Linia 48:
	* io, mx, px, cchr, cmem - wejście/wyjście i kanały		* io, mx, px, cchr, cmem - wejście/wyjście i kanały
	* term, wnch, 9045, flop, pnch, pnrd - urządzenia zewnętrzne		* term, wnch, 9045, flop, pnch, pnrd - urządzenia zewnętrzne
			* em4h - emulator
	* crk5 - CROOK-5		* crk5 - CROOK-5
	* all - komponent specjalny, zawiera wszystkie pozostałe komponenty		* all - komponent specjalny, zawiera wszystkie pozostałe komponenty

Amo o 22:05, 10 lis 2014

2014-11-10T22:05:27Z

← poprzednia wersja		Wersja z 22:05, 10 lis 2014
Linia 1:		Linia 1:
	Plik konfiguracyjny EM400 pozwala skonfigurować parametry sprzętowe emulowanej maszyny i jest wymagany do uruchomienia emulatora. ~~Domyślne EM400 próbuje załadować następuące pliki konfiguracyjne:~~		Plik konfiguracyjny EM400 pozwala skonfigurować parametry sprzętowe emulowanej maszyny i jest wymagany do uruchomienia emulatora. Jeśli użytkownik podał nazwę pliku konfiguracyjnego w linii poleceń (używając przełącznika '''-c'''), zostanie on użyty. Jeśli nie, domyślnie używany jest plik '''~/.em400/em400.cfg'''.
	* '''~~em400.cfg~~''' ~~(w katalogu bieżącym~~)
	* '''~/.em400/em400.cfg''' ~~(konfiguracja użytkownika)~~
	* '''/etc/em400.~~cfg''' (konfiguracja systemowa)~~
	Jeśli jeden z plików uda się poprawnie załadować, dalesze nie są sprawdzane. Powyższa lista plików jest ignorowana, jeśli użytkownik użyje przełącznika '''-c''' w [[EM400 - linia poleceń\|linii poleceń]]

	= Składnia pliku konfiguracyjnego =		= Składnia pliku konfiguracyjnego =
Linia 58:		Linia 54:

	* '''enabled''' - aktywuj logowanie (true/false)		* '''enabled''' - aktywuj logowanie (true/false)
	* '''file''' - plik, to którego zapisywany będzie log		* '''file''' - plik, do którego zapisywany będzie log
	* '''levels''' - poziomy logowania ~~opisywane~~ w składni: '''komponent=poziom[,komponent=poziom[,...]]'''. Ustawione poziomy mówią jakie zdarzenia (do jakiego poziomu w danym komponencie) będą logowane.		* '''levels''' - poziomy logowania opisane w składni: '''komponent=poziom[,komponent=poziom[,...]]'''. Ustawione poziomy mówią jakie zdarzenia (do jakiego poziomu w danym komponencie) będą logowane.
	* '''pname_offset''' - opcja ma znaczenie, jeśli w emulatorze uruchamiany jest system CROOK-5. Jej użycie powoduje, że dla każdego zdarzenia generowanego w procesorze, będzie logowana nazwa procesu, w którego kontekście znajduje się system operacyjny. W zależności od wersji jądra systemu ~~offset~~ nazwy procesu jest ~~inny~~: dla wersji "N" wynosi 52, a dla wersji "P" - 54. Logowanie nazwy procesu nie jest w 100% precyzyjne, ponieważ jest ona aktualizowana tylko przy wywołaniach instrukcji LIP i SP.		* '''pname_offset''' - opcja ma znaczenie, jeśli w emulatorze uruchamiany jest system CROOK-5. Jej użycie powoduje, że dla każdego zdarzenia generowanego w procesorze, będzie logowana nazwa procesu, w którego kontekście znajduje się system operacyjny. W zależności od wersji jądra systemu przesunięcie nazwy procesu jest inne: dla jąder w wersji "N" wynosi 52, a dla wersji "P" - 54. Logowanie nazwy procesu nie jest w 100% precyzyjne, ponieważ jest ona aktualizowana tylko przy wywołaniach instrukcji LIP i SP.

			Przykładowy blok konfiguracji logowania:

			emulog {
			enabled = true
			levels = "all=1,em4h=2,wnch=10"
			pname_offset = 54
			}

	== Urządzenia zewnętrzne ==		== Urządzenia zewnętrzne ==

Amo: /* Składnia pliku konfiguracyjnego */

2014-11-10T22:00:38Z

Składnia pliku konfiguracyjnego

← poprzednia wersja		Wersja z 22:00, 10 lis 2014
Linia 10:		Linia 10:

	* '''computer''' - konfiguracja procesora i emulacji		* '''computer''' - konfiguracja procesora i emulacji
			* '''log''' - konfiguracja logowania
	* '''channel n''' - konfiguracja kanałów dla n = 0...15		* '''channel n''' - konfiguracja kanałów dla n = 0...15

Amo o 21:58, 10 lis 2014

2014-11-10T21:58:33Z

@@ Linia 44: / Linia 44: @@
          mem_os_segments = 2
+  }
 == Urządzenia zewnętrzne ==

Amo o 21:00, 23 wrz 2014

2014-09-23T21:00:53Z

← poprzednia wersja		Wersja z 21:00, 23 wrz 2014
Linia 18:		Linia 18:
	* '''speed_real''' - zachowanie prędkości emulacji odpowiadającej prawdziwej MERZE-400 (true/false).		* '''speed_real''' - zachowanie prędkości emulacji odpowiadającej prawdziwej MERZE-400 (true/false).
	* '''timer_step''' - okres [[Przerwanie_zegarowe\|zegara systemowego]] (w milisekundach)		* '''timer_step''' - okres [[Przerwanie_zegarowe\|zegara systemowego]] (w milisekundach)
			* '''timer_start''' - uruchom zegar systemowy przy starcie emulatora (true/false)
	* '''cpu_mod''' - włącz modyfikacje procesora do zgodności z MX-16 (true/false)		* '''cpu_mod''' - włącz modyfikacje procesora do zgodności z MX-16 (true/false)
	* '''cpu_user_io_illegal''' - instrukcje IN/OU nielegalne dla programów użytkownika (true/false)		* '''cpu_user_io_illegal''' - instrukcje IN/OU nielegalne dla programów użytkownika (true/false)
Linia 24:		Linia 25:
	* '''mem_mega''' - ilość bloków [[Pamięć MEGA\|pamięci MEGA]] (bloki 64ksłowa)		* '''mem_mega''' - ilość bloków [[Pamięć MEGA\|pamięci MEGA]] (bloki 64ksłowa)
	* '''mem_mega_prom''' - nazwa pliku z obrazem pamięci PROM MEGA		* '''mem_mega_prom''' - nazwa pliku z obrazem pamięci PROM MEGA
			* '''mem_mega_boot''' - boot systemu z pamięci MEGA (true/false)
			* '''cpu_stop_on_nomem''' - procesor przechodzi w stan STOP przy odwołaniu to nieskonfigurowanego segmentu pamięci w bloku 0 (true/false)
	* '''mem_os_segments''' - liczba segmentów zarezerwowanych dla systemu operacyjnego (1 lub 2)		* '''mem_os_segments''' - liczba segmentów zarezerwowanych dla systemu operacyjnego (1 lub 2)

Linia 31:		Linia 34:
	speed_real = false		speed_real = false
	timer_step = 10		timer_step = 10
			timer_start = true
	cpu_user_io_illegal = true		cpu_user_io_illegal = true
	cpu_awp = true		cpu_awp = true
Linia 37:		Linia 41:
	mem_mega = 16		mem_mega = 16
	mem_mega_prom = mega_prom.img		mem_mega_prom = mega_prom.img
			mem_mega_boot = true
	mem_os_segments = 2		mem_os_segments = 2
	}		}