src/ieee754/fpdiv/div0.py

   1 """IEEE754 Floating Point Divider
   2
   3 Relevant bugreport: http://bugs.libre-riscv.org/show_bug.cgi?id=99
   4 """
   5
   6 from nmigen import Module, Signal, Cat, Elaboratable
   7 from nmigen.cli import main, verilog
   8
   9 from ieee754.fpcommon.fpbase import (FPNumBaseRecord, Overflow)
  10 from ieee754.fpcommon.fpbase import FPState
  11 from ieee754.fpcommon.denorm import FPSCData
  12 from ieee754.fpcommon.getop import FPPipeContext
  13 from ieee754.div_rem_sqrt_rsqrt.div_pipe import DivPipeInputData
  14
  15
  16 class FPDivStage0Mod(Elaboratable):
  17
  18     def __init__(self, pspec):
  19         self.pspec = pspec
  20         self.i = self.ispec()
  21         self.o = self.ospec()
  22
  23     def ispec(self):
  24         return FPSCData(self.pspec, False)
  25
  26     def ospec(self):
  27         return DivPipeInputData(self.pspec)
  28
  29     def process(self, i):
  30         return self.o
  31
  32     def setup(self, m, i):
  33         """ links module to inputs and outputs
  34         """
  35         m.submodules.div0 = self
  36         m.d.comb += self.i.eq(i)
  37
  38     def elaborate(self, platform):
  39         m = Module()
  40
  41         # XXX TODO, actual DIV code here.  this class would be
  42         # "step one" which takes the pre-normalised data (see ispec) and
  43         # *begins* the processing phase (enters the massive DIV
  44         # pipeline chain) - see ospec.
  45
  46         # INPUT SPEC: FPSCData
  47         # OUTPUT SPEC: DivPipeInputData
  48
  49         # NOTE: this stage does *NOT* do *ACTUAL* DIV processing,
  50         # it is PURELY the *ENTRY* point into the chain, performing
  51         # "preparation" work.
  52
  53         with m.If(~self.i.out_do_z):
  54             # do conversion here, of both self.i.a and self.i.b,
  55             # into DivPipeInputData dividend and divisor.
  56
  57             # the mantissas, having been de-normalised (and containing
  58             # a "1" in the MSB) represent numbers in the range 0.5 to
  59             # 0.9999999-recurring.  the min and max range of the
  60             # result is therefore 0.4999999 (0.5/0.99999) and 1.9999998
  61             # (0.99999/0.5).
  62
  63             # zero-extend the mantissas (room for sticky/guard)
  64             # plus the extra MSB.  See DivPipeBaseStage.get_core_config
  65             am0 = Signal(len(self.i.a.m)+3, reset_less=True)
  66             bm0 = Signal(len(self.i.b.m)+3, reset_less=True)
  67             m.d.comb += [
  68                          am0.eq(Cat(0, 0, self.i.a.m, 0)),
  69                          bm0.eq(Cat(0, 0, self.i.b.m, 0))
  70                         ]
  71
  72             m.d.comb += [self.o.z.e.eq(self.i.a.e - self.i.b.e + 1),
  73                          self.o.z.s.eq(self.i.a.s ^ self.i.b.s),
  74                          self.o.dividend.eq(am0), # TODO: check
  75                          self.o.divisor_radicand.eq(bm0), # TODO: check
  76                          self.o.operation.eq(Const(0)) # TODO check: DIV
  77                 ]
  78
  79         # these are required and must not be touched
  80         m.d.comb += self.o.oz.eq(self.i.oz)
  81         m.d.comb += self.o.out_do_z.eq(self.i.out_do_z)
  82         m.d.comb += self.o.ctx.eq(self.i.ctx)
  83
  84         return m
  85
  86
  87 class FPDivStage0(FPState):
  88     """ First stage of div.
  89     """
  90
  91     def __init__(self, pspec):
  92         FPState.__init__(self, "divider_0")
  93         self.mod = FPDivStage0Mod(pspec)
  94         self.o = self.mod.ospec()
  95
  96     def setup(self, m, i):
  97         """ links module to inputs and outputs
  98         """
  99         self.mod.setup(m, i)
 100
 101         # NOTE: these could be done as combinatorial (merge div0+div1)
 102         m.d.sync += self.o.eq(self.mod.o)
 103
 104     def action(self, m):
 105         m.next = "divider_1"