From c5aa929d4c89337964f8bdba8908ddedec84c146 Mon Sep 17 00:00:00 2001 From: Sean Cross Date: Thu, 2 Jan 2020 16:24:12 +0800 Subject: [PATCH] cores: timer: clean up wording for timer documentation This fixes some formatting errors with the timer documentation, such as the lack of a space between the first and second sentences. It also fixes some grammar for documentation of various fields. Signed-off-by: Sean Cross --- litex/soc/cores/timer.py | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/litex/soc/cores/timer.py b/litex/soc/cores/timer.py index 55e8483db..570bf650d 100644 --- a/litex/soc/cores/timer.py +++ b/litex/soc/cores/timer.py @@ -48,17 +48,18 @@ class Timer(Module, AutoCSR, ModuleDoc): CPU can also do software polling with ``update_value`` and ``value`` to know the elapsed duration) """ def __init__(self, width=32): - self._load = CSRStorage(width, description="""Load value when Timer is (re-)enabled.""" + - """In One-Shot mode, the value written to this register specify the Timer's duration in + self._load = CSRStorage(width, description="""Load value when Timer is (re-)enabled. + In One-Shot mode, the value written to this register specifies the Timer's duration in clock cycles.""") - self._reload = CSRStorage(width, description="""Reload value when Timer reaches 0.""" + - """In Periodic mode, the value written to this register specify the Timer's period in + self._reload = CSRStorage(width, description="""Reload value when Timer reaches ``0``. + In Periodic mode, the value written to this register specify the Timer's period in clock cycles.""") - self._en = CSRStorage(1, description="""Enable of the Timer.""" + - """Set if to 1 to enable/start the Timer and 0 to disable the Timer""") - self._update_value = CSRStorage(1, description="""Update of the current countdown value."""+ - """A write to this register latches the current countdown value to `value` register.""") - self._value = CSRStatus(width, description="""Latched countdown value""") + self._en = CSRStorage(1, description="""Enable flag of the Timer. + Set this flag to ``1`` to enable/start the Timer. Set to ``0`` to disable the Timer.""") + self._update_value = CSRStorage(1, description="""Update trigger for the current countdown value. + A write to this register latches the current countdown value to ``value`` register.""") + self._value = CSRStatus(width, description="""Latched countdown value. + This value is updated by writing to ``update_value``.""") self.submodules.ev = EventManager() self.ev.zero = EventSourceProcess()