Tweaks after Honza's full proof-reading.

Author: malinajan

existujici-reseni.tex

@@ -1,12 +1,12 @@
-Nyní představíme v~současnosti nejrozšířenější systémy pro \textit{digitální}
+Nyní představíme v~současnosti nejrozšířenější standardy pro \textit{digitální}
 řízení modelové železnice. Prozkoumáme zařízení, která tyto standardy
 podporují, a~zhodnotíme jejich vlastnosti. Bude vyhodnoceno, jestli zařízení
 naplňují požadavky definované v~předchozí kapitole.
 
 \section{Digital Command Control} \label{sec:dcc}
 
 \textit{Digital Command control} (\gls{dcc}) je celosvětově nejrozšířenější
-systém pro \textit{digitální}\footnote{\textit{Digitální} znamená, že mezi
+standard pro \textit{digitální}\footnote{\textit{Digitální} znamená, že mezi
 jednotlivými prvky řízení proudí digitální data.} řízení modelové železnice
 \cite{dcc_systems:web}. K~\gls{dcc} existují alternativy, které však v~Evropě
 nejsou rozšířené, proto je nebudeme uvažovat.\footnote{Toto
@@ -17,7 +17,7 @@ \section{Digital Command Control} \label{sec:dcc}
 způsob zapojení vodičů pod kolejištěm) až po komunikační protokoly. \gls{dcc}
 je otevřený standard vytvořený organizací \textit{National Model Railroad
 Association} (\gls{nmra}), která sdružuje modelářské kluby (a~tedy i~modeláře),
-které jsou přímými uživateli systému \gls{dcc}. Systém \gls{dcc} je tedy
+jež jsou přímými uživateli \gls{dcc}. Standard \gls{dcc} je tedy
 navržen modeláři k~naplnění potřeb modelářů.
 
 Jednotlivé prvky systému \gls{dcc} jsou znázorněny v~\ref{fig:dcc-overview}.
@@ -46,7 +46,7 @@ \section{Digital Command Control} \label{sec:dcc}
 
 Ke sběrnici ovladačů jsou připojené buď fyzické ovladače, nebo počítače.
 Operátor provozu zadává příkazy, například otočením kolečka ovladače nebo
-interakcí s~příslušným software, tyto příkazy jsou přeposlány do centrály,
+interakcí s~příslušným softwarem, tyto příkazy jsou přeposlány do centrály,
 centrála je dále přeposílá dekodérům, které přímo vykonávají požadované akce.
 
 Na \textit{sběrnici zpětného hlášení} jsou připojeny moduly s~digitálními vstupy,
@@ -89,13 +89,13 @@ \section{Digital Command Control} \label{sec:dcc}
 a~pro sběr informací z~kolejiště jsou použity 2~různé sběrnice: \textit{dcc
 signál} a~\textit{sběrnice zpětného hlášení}. Platí totiž, že signál \gls{dcc}
 je pouze jednosměrný. Signál putuje z~\gls{dcc} centrály přes
-\textit{zesilovače} a přes koleje do lokomotiv a~vozů, které poveluje.
+\textit{zesilovače} a přes koleje do lokomotiv, vozů a~statických dekodérů, které poveluje.
 Existují jen velice omezené prostředky k~poslání dat z~lokomotivy zpět do
 \gls{dcc} centrály\footnote{Takovému systému říkáme \textit{RailCom}
 \cite{railcom:web}.}. Tyto prostředky navíc vznikly až v~pozdějších verzích
 normy \gls{dcc}, takže dnes nejsou všeobecně zaužívané \cite{railcom:web}.
-Sběrnice \gls{dcc} je tedy prakticky vzato jednosměrná, dokonce bez odpovědí
-dekodérů na příkazy
+Sběrnice \gls{dcc} je tedy prakticky vzato jednosměrná – bez odpovědí
+dekodérů na příkazy.
 
 To znamená, že centrála musí DCC příkazy posílat opakovaně, aby zaručila, že je
 dekodér skutečně přijme. Může se totiž snadno stát, že lokomotiva zrovna není
@@ -150,7 +150,7 @@ \section{Digital Command Control} \label{sec:dcc}
 	aby strojvedoucí viděl správnou návěst, protože nesprávná návěst
 	by mu mohla povolit jízdu, přestože se například proti němu blíží vlak. Nebo
 	by například mohla povolit jízdu vyšší rychlostí, než jaká je v~daném
-	úseku předepsaná a~vlak by pak nemusel stihnout později zabrzdit. Proto se
+	úseku předepsaná, a~vlak by později nemusel stihnout zabrzdit. Proto se
 	na skutečné železnici kontroluje, že světly návěstidel, která mají být
 	rozsvícená, skutečně prochází proud.}
 
@@ -209,7 +209,7 @@ \subsubsection{\textbf{RSbus}}
 \textit{RSbus} je sběrnice firmy \textit{Lenz Elektronik}. Oproti \textit{S88}
 je organizována do topologie sběrnice (viz obr. \ref{fig:rs-topology}). Jednotlivé
 moduly jsou napájeny samostatně, sběrnice je dimenzovaná až na 128 modulů,
-každý s~8 digitálními vstupy \cite{rs:web} \cite{rs_lib:web}.
+každý s~8~digitálními vstupy \cite{rs:web} \cite{rs_lib:web}.
 
 \begin{figure}[ht!]
 \includegraphics[width=\textwidth]{data/rs.pdf}
@@ -289,21 +289,21 @@ \section{Závěr}
 modelové železnice. Bylo zkoumáno, jestli komerční produkty splní požadavky
 definované v~\ref{subsec:gen_requirements}. Po vyloučení technicky
 nezpůsobilých řešení zbyly sběrnice LocoNET (s~poznámkou,
-že její nasazení by bylo finančně náročné a~pracné) a \textit{\gls{bidib}}.
+že její nasazení by bylo finančně náročné a~pracné) a \gls{bidib}.
 
 Při uvažování sběrnice LocoNET vyvstal problém s~integrací ovládání
 návěstidel. Tento problém je obecnějšího rázu – jakékoliv komerční řešení není
-schopné nabídnout takovou flexibilitu, jakou bychom v~\gls{kmz} potřebovali.
+schopné nabídnout takovou flexibilitu, jakou \gls{kmz} potřebuje.
 Je nutné integrovat systém řízení kolejiště se současnými periferiemi, ale
 i~s~periferiemi budoucími. Je chtěné mít možnost pružně reagovat na nové
 periferie, které se objeví například za 10 let.
 
-Uvažme také aspekt zpětné kompatibility – vlastní systém nám umožní co možná
+Uvažme také aspekt zpětné kompatibility – vlastní systém umožní co možná
 nejrozumněji zachovat kompatibilitu se stávajícím systémem řízení kolejiště
 a~minimalizovat tak finanční náklady a čas nutný pro aktualizaci systému.
 Nutnost rozumné zpětné kompatibility tak fakticky vylučuje i~nasazení
 \gls{bidib}.
 
 Vnímejme tuto kapitolu tedy především jako přehled technologií, které se
-při řízení současné digitální modelové železnice používají. Přistupme
+pro řízení současné digitální modelové železnice používají. Přistupme
 k~návrhu nástupce současného systému \gls{mtb} výrobou vlastních komponent.

mtb-2-avr.tex

@@ -1,15 +1,15 @@
 \newpage
 \section{MTB-2-AVR} \label{sec:mtb-2-avr}
 
-Aby nebylo nutné všechny současné \gls{mtbuni} desky vyměňovat za desky nové,
-je třeba současné desky povýšit tak, aby podporovaly nový protokol \gls{mtbbus} v4.
-Kvůli omezenosti procesoru v~současných modulech \gls{mtbuni} není možné tuto
+Aby nebylo nutné všechny současné \gls{mtbuni} moduly vyměnit za moduly nové,
+je třeba současné moduly povýšit tak, aby podporovaly nový protokol \gls{mtbbus} v4.
+Kvůli omezenosti procesoru v~současných \gls{mtbuni} není možné tuto
 úpravu provést pouze změnou firmwaru, viz \ref{sec:mtb_fail}.
 
-Výhodou je, že procesory na současných \gls{mtbuni} modulech jsou
+Procesory v~současných \gls{mtbuni} modulech jsou
 v~\gls{dil} patici. Nabízí se tedy přirozená cesta najít nový procesor
 odpovídajícího rozložení pinů. Procesor, který by měl vyhovující rozložení pinů
-a požadované parametry, bohužel neexistuje (uvažován byl například procesor
+a požadované parametry, bohužel neexistuje (uvažován byl například
 \textit{ATtiny4313}). Proto se autor této práce vydal cestou výroby nástavné
 desky, která se zasune do \gls{dil} patice současné \gls{mtbuni} desky
 a~která na sobě bude mít \gls{smd} procesor.
@@ -33,7 +33,7 @@ \section{MTB-2-AVR} \label{sec:mtb-2-avr}
 \gls{mtbuni}, MTB-UNIm nebo MTB-TTL. Srdcem desky je procesor
 \textit{ATmega328p} autorovy oblíbené architektury \textit{AVR}.
 Konkrétně tento model byl zvolen, protože obsahuje dostatečnou kapacitu paměti
-na bootloader a protože jej \textit{JLCPCB} má mezi \textit{basic} součástkami
+pro bootloader a~protože jej \textit{JLCPCB} má mezi \textit{basic} součástkami
 (viz \ref{subsec:mtbusb:hardware}).
 
 Schéma a \gls{dps} jsou vyvinuty jako openhardware projekt, dostupné
@@ -45,12 +45,13 @@ \section{MTB-2-AVR} \label{sec:mtb-2-avr}
 obsahuje tlačítko (pro unifikaci hardwaru všech \gls{mtbuni} modulů).
 
 Jak již bylo zmíněno, nástavná deska se osazuje do patic současných
-\gls{mtbuni}, MTB-UNIm i~MTB-TTL desek. Přitom u~\gls{mtbuni} modulů by měl
+\gls{mtbuni}, MTB-UNIm i~MTB-TTL desek (viz \ref{fig:mtb-2-avr-inside}).
+Přitom u~\gls{mtbuni} modulů by měl
 procesor podporovat \gls{ir} čidla na vstupech, u~ostatních modulů ne. Deska \textit{MTB-2-AVR}
-a~firmware jsou proto navrženy tak, aby uměly detekovat, v~jaké desce se
-nachází (byl identifikován a využit HW rozdíl modulů). Podle detekovaného typu
+a~firmware jsou proto navrženy tak, aby uměly detekovat, v~jakém modulu se
+nachází (byl identifikován a~využit HW rozdíl modulů). Podle detekovaného typu
 modulu procesor buď zapne, nebo vypne podporu \gls{ir} čidel. Do počítače pak přes
-\gls{mtbbus} protokol nahlásí, jestli modul \gls{ir} čidla podporuje nebo ne.
+\gls{mtbbus} nahlásí, jestli modul \gls{ir} čidla podporuje nebo ne.
 
 Zde mimochodem využijeme \textit{Module specific command}
 (\ref{subsub:mtbbus-messages}). Modulu \textit{MTB-2-AVR} lze poslat příkaz,

mtb-daemon.tex

@@ -6,12 +6,12 @@ \section{MTB Daemon}
 umožnit jeho ovládání více různým aplikacím. K~tomuto účelu vystavuje \gls{mtb}
 Daemon \gls{tcp} server, ke kterému se řídicí programy mohou připojit.
 
-\subsection{Protokol \gls{tcp} serveru} \label{sec:daemon:proto}
+\subsection{Protokol TCP serveru} \label{sec:daemon:proto}
 
 \gls{tcp} server musí umožňovat oboustrannou komunikaci – jak od klienta k~serveru
 (\textit{požadavek, odpověď}), tak od serveru ke klientovi (\textit{asynchronní
 události}). Například protokol \textit{http} v~kombinaci s~\textit{REST \gls{api}}
-tedy není možné použít. Z~běžně používaných technologií byly zvažovány
+tedy není vhodné použít. Z~běžně používaných technologií byly zvažovány
 \textit{websockets}, ty ale kvůli složitější inicializaci nebyly využity.
 
 Autor zvolil snad nejjednodušší možný komunikační protokol: \gls{tcp} spojení

mtb-net-lib.tex

@@ -5,14 +5,14 @@ \section{hJOP MTB Network RCS knihovna} \label{sec:mtb-net-lib}
 v~rámci této diplomové práce. Jeho účelem je propojit stávající systém řízení
 kolejiště \textit{hJOP}\footnote{\url{https://hjop.kmz-brno.cz/}, používá se
 pro řízení všech kolejišť v~\gls{kmz}. Implementovaný na platformě OS Windows.}
-a~\textit{MTB Daemon}. \textit{hJOP} pro přístup k~hardwaru řízení
-příslušenství používá tzv. \textit{RCS API} \footnote{\textit{Railroad Control
+a~MTB Daemon. hJOP pro přístup k~hardwaru řízení
+příslušenství používá tzv. \textit{RCS API}\footnote{\textit{Railroad Control
 System API}, viz \url{https://hjop.kmz-brno.cz/rcs}.}. Systém pro řízení
-příslušenství se připojuje k~\textit{hJOP} jako dynamicky linkovaná knihovna,
+příslušenství se připojuje k~hJOP jako dynamicky linkovaná knihovna,
 která implementuje \textit{RCS API}.
 
 Byla tedy implementována jednoduchá knihovna, která se přilinkuje do
-\textit{hJOP} a připojí se k~\textit{MTB Daemon}. Pro implementaci bylo
+hJOP a připojí se k~MTB Daemon. Pro implementaci bylo
 opět zvoleno \texttt{C++} a framework \texttt{Qt}. K~této volbě vedly důvody
 popsané v~kapitole \ref{sec:daemon:tools}.
 

mtb-uni-v4.tex

@@ -26,8 +26,8 @@ \subsection{Základní parametry}
 Tento počet se autor práce rozhodl zachovat, protože vhodně škáluje pro malé
 i~velké železniční stanice na modelových kolejištích.
 Současné \gls{mtbuni} a~MTB-TTL moduly používají různé konektory
-pro připojení periferií: svorkovnice nebo nasouvací konektory typu \texttt{PSH}
-\footnote{Např. \url{https://www.gme.cz/konektor-se-zamkem-psh02-04pg}.}.
+pro připojení periferií: svorkovnice nebo nasouvací konektory typu
+\texttt{PSH}\footnote{Např. \url{https://www.gme.cz/konektor-se-zamkem-psh02-04pg}.}.
 Modul \gls{mtbuni} v4 umožňuje variantní osazení jak svorkovnic, tak konektorů
 \texttt{PSH}. Tím modul slučuje současné moduly \gls{mtbuni}, MTB-UNIm a
 MTB-TTL do jediné \gls{dps}, což zjednodušuje údržbu a~vývoj.
@@ -43,9 +43,8 @@ \subsection{Základní parametry}
 Deska plošných spojů je navržena tak, aby byly zachovány rozměry a~umístění
 upevňovacích otvorů se současným nejmenším modulem – MTB-TTL.
 
-Návrh této desky vznikal ve spolupráci s~\textit{Mendelovou univerzitou
-v~Brně}, (\textit{MENDELU}). Schéma vytvořil Robert Čížek, \gls{dps},
-firmware a~koncepční návrh modulu jsou dílem autora této práce.
+Návrh této desky vznikal ve spolupráci s~MENDELU. Schéma vytvořil Robert Čížek,
+\gls{dps}, firmware a~koncepční návrh modulu jsou dílem autora této práce.
 
 
 \subsection{Hardware}
@@ -67,7 +66,7 @@ \subsection{Hardware}
 v~příloze \ref{fig:mtb-uni-4-sch}. Okomentujme nyní zajímavé prvky schématu
 a~\gls{dps}.
 
-Jádrem modulu je procesor \textit{ATmega128A}. Autor této práce si zvolil
+Jádrem modulu je procesor \textit{ATmega128}. Autor této práce si zvolil
 procesor architektury \textit{AVR}, protože s~používáním těchto procesorů má
 dlouholeté zkušenosti. Model \textit{ATmega128} byl pak zvolen proto, že je to
 nejmenší model rodiny \textit{ATmega}, který obsahuje požadované množství pinů.
@@ -136,7 +135,7 @@ \subsubsection{\textbf{Výstupy}}
 
 Výstupy obsahují ochranu proti přivedení vysokého napětí, kterou realizuje
 stejný obvod, jako na obrázku \ref{fig:mtbuni-input} (obvod pod diodou
-\texttt{D1}). Obdobný obvod realizuje ochranu také proti vysokému napájecímu
+\texttt{D1}). Obdobný obvod realizuje také ochranu proti vysokému napájecímu
 napětí celého modulu. Viz kompletní schéma \ref{fig:mtb-uni-4-sch}.
 
 \subsubsection{\textbf{Adresování}}

mtb-usb-v4.tex

@@ -28,20 +28,19 @@ \subsection{Komunikační protokol s~počítačem}
 počítačem a~\gls{mtbusb} je požadavek o~přeposlání zprávy mezi \gls{usb}
 a~\gls{mtbbus}. Tato zpráva umožňuje počítačovému programu poslat libovolnou
 zprávu libovolnému \gls{mtb} modulu (a~naopak), aniž by \gls{mtbusb} deska
-musela znát sémantiku této zprávy. Protokol sběrnice \gls{mtbbus} byl
-vytvářen přesně s~tímto cílem.
+musela znát sémantiku této zprávy.
 
 Na \gls{mtbusb} desku můžeme tedy pohlížet v~zásadě jako na tenkého
 přeposílatele mezi dvěma různými sběrnicemi – tzv. \textit{gateway}.
 
 Plnohodnotná specifikace protokolu mezi počítačem a \gls{mtbusb} je
-k~dispozici na \url{https://github.com/kmzbrnoI/mtbbus-protocol/tree/master/pc}.
+k~dispozici online\footnote{\url{https://github.com/kmzbrnoI/mtbbus-protocol/tree/master/pc}}.
 Popišme nyní stručně návrh protokolu.
 
-Mezi počítačem a \gls{mtbusb} deskou se komunikuje po virtuálním sériovém portu
-(tzv. \textit{\gls{cdc}}) tunelovaným skrze \gls{usb} rozhraní. Toto řešení
+Mezi počítačem a \gls{mtbusb} se komunikuje po virtuálním sériovém portu
+(\gls{cdc}) tunelovaným skrze \gls{usb}. Toto řešení
 bylo vybráno, protože je prakticky standardem pro připojení speciálních
-periferií k~počítači (zvažován byl také například \textit{\gls{hid}}).
+periferií k~počítači (zvažován byl také \textit{\gls{hid}}).
 \gls{usb} nezná pojem zprávy tak, jak bychom
 vyžadovali\footnote{Při užití třídy \gls{cdc} se data posílají nejčastěji
 každou milisekundu a to v~bloku o~nejvýše 64 bytech.  Počítačová aplikace díky
@@ -93,6 +92,8 @@ \subsection{Komunikační protokol s~počítačem}
 
 Odpovědí na tento příkaz je seznam aktivních \gls{mtb} modulů.
 
+\item \textbf{Ping}
+
 \end{itemize}
 
 Zprávy z~\gls{mtbusb} pro počítač jsou:
@@ -105,7 +106,7 @@ \subsection{Komunikační protokol s~počítačem}
 Zpráva je odeslána počítači při odpovědi \gls{mtb} modulu na zprávu z~počítače
 nebo na pravidelný sken \gls{mtb} modulů. Z~pohledu počítače tak přichází jak
 odpovědi na příkazy pro \gls{mtb} modul, které poslal počítač, tak asynchronní
-události – například informace o~změně stavu vstupů.
+události – informace o~změně stavu vstupů.
 
 \item \textbf{\gls{mtbusb} Information}
 
@@ -133,7 +134,7 @@ \subsection{Komunikační protokol s~počítačem}
 Vlastností \gls{mtbbus} je, že každý \gls{mtb} modul musí vždy
 odpovědět na každou zprávu, kterou přijme\footnote{Výjimkou jsou pouze
 \textit{broadcast} zprávy.}. Protože \gls{mtbbus} je potenciálně nespolehlivé
-médium, na kterém integritu příkazů kontrolujeme vlastními mechanismy, provádí
+médium, na kterém integritu příkazů zajišťujeme vlastními mechanismy, provádí
 modul \gls{mtbusb} retransmisi zpráv \gls{mtb} modulům v~případě, že na zprávu
 nepřijde žádná odpověď, a~to až třikrát. Proto je součástí zprávy \textit{Packet
 from \gls{mtbbus}} také počítadlo, které říká, na kolikátý pokus byla
@@ -155,6 +156,7 @@ \subsection{Hardware} \label{subsec:mtbusb:hardware}
 Srdcem \gls{mtbusb} modulu je procesor \texttt{STM32F103}, což je moderní
 mikrokontrolér architektury \textit{ARM}. Autor jej zvolil z~několika důvodů.
 
+\newpage
 \begin{compactenum}
 \item Procesor \texttt{STM32F103} má hardwarovou podporu \gls{usb}.
 \item Procesory \texttt{STM32} nabízí velké velikosti pamětí a výpočetní výkon.
@@ -226,7 +228,7 @@ \subsection{Hardware} \label{subsec:mtbusb:hardware}
 vyvedení konektorů a indikačních \gls{led} není třeba do krabičky frézovat. Navíc lze
 na krabičku velice elegantně nalepit potisk, který vysvětluje použití
 jednotlivých konektorů a~význam \gls{led}. Celé řešení je zobrazeno na
-obrázkcích \ref{fig:mtbusb-prototype} a \ref{fig:mtbusb-inside}.
+obrázcích \ref{fig:mtbusb-prototype} a \ref{fig:mtbusb-inside}.
 
 
 \subsection{Firmware}