doc: update COMPAT_SUMMARY.

This commit is contained in:
whitequark 2019-01-19 01:01:32 +00:00
parent e3b5b2acc8
commit 94b23dd2c8

View file

@ -14,6 +14,7 @@ API change legend:
- *a=→b=*: parameter *a* renamed to *b*
- *a=∼*: parameter *a* removed
- *.a=→.b*: attribute *a* renamed to *b*
- *.a=∼*: attribute *a* removed
- *?*: no decision made yet
When describing renames or replacements, `mod` refers to a 3rd-party package `mod` (no nMigen implementation provided), `.mod.item` refers to `nmigen.mod.item`, and "(import `.item`)" means that, while `item` is provided under `nmigen.mod.item`, it is aliased to, and should be imported from a shorter path for readability.
@ -49,18 +50,18 @@ Compatibility summary
- (−) `FullMemoryWE` ?
- (−) `MemoryToArray` ?
- (−) `SplitMemory` ?
- (−) `specials` **obs**
- (−) `Special` ?
- (−) `Tristate` ?
- (+) `TSTriple` → `.lib.io.TSTriple`, `bits_sign=`→`shape=`
- (−) `Instance` ?
- (+) `Memory` id
- (+) `.get_port` **obs** → `.read_port()` + `.write_port()`
- (+) `_MemoryPort` **obs**
- (⊕) `specials` **obs**
- (⊙) `Special` **brk**
- (⊕) `Tristate` → `.lib.io.Tristate`, `target=`→`io=`
- (⊕) `TSTriple` → `.lib.io.TSTriple`, `bits_sign=`→`shape=`
- (⊕) `Instance` → `.hdl.ir.Instance`
- (⊕) `Memory` id
- (⊕) `.get_port` **obs** → `.read_port()` + `.write_port()`
- (⊕) `_MemoryPort` **obs**
<br>Note: nMigen separates read and write ports.
- (+) `READ_FIRST`/`WRITE_FIRST` **obs**
- (⊕) `READ_FIRST`/`WRITE_FIRST` **obs**
<br>Note: `READ_FIRST` corresponds to `mem.read_port(transparent=False)`, and `WRITE_FIRST` to `mem.read_port(transparent=True)`.
- (-) `NO_CHANGE` **brk**
- (⊙) `NO_CHANGE` **brk**
<br>Note: in designs using `NO_CHANGE`, repalce it with an asynchronous read port and logic implementing required semantics explicitly.
- (−) `structure` → `.hdl.ast`
- (+) `DUID` id
@ -79,7 +80,7 @@ Compatibility summary
- (+) `ResetSignal` id, `cd=`→`domain=`
- (+) `_Statement` → `Statement`
- (+) `_Assign` → `Assign`, `l=`→`lhs=`, `r=`→`rhs=`
- (-) `_check_statement` **obs** → `Statement.wrap`
- (+) `_check_statement` **obs** → `Statement.wrap`
- (+) `If` **obs** → `.hdl.dsl.Module.If`
- (+) `Case` **obs** → `.hdl.dsl.Module.Switch`
- (+) `_ArrayProxy` → `.hdl.ast.ArrayProxy`, `choices=`→`elems=`, `key=`→`index=`
@ -122,7 +123,7 @@ Compatibility summary
- (−) `genlib` → `.lib`
- (−) `cdc` ?
- (−) `MultiRegImpl` ?
- (+) `MultiReg` id
- (⊕) `MultiReg` id
- (−) `PulseSynchronizer` ?
- (−) `BusSynchronizer` ?
- (−) `GrayCounter` ?
@ -138,11 +139,11 @@ Compatibility summary
- (−) `divider` ?
- (−) `Divider` ?
- (−) `fifo` ?
- (−) `SyncFIFO` ?
- (−) `SyncFIFOBuffered` ?
- (⊕) `_FIFOInterface` → `FIFOInterface`
- (⊕) `SyncFIFO` id, `.fifo=`∼
- (⊕) `SyncFIFOBuffered` id, `.fifo=`∼
- (−) `AsyncFIFO` ?
- (−) `AsyncFIFOBuffered` ?
- (−) `_FIFOInterface` ?
- (+) `fsm` **obs**
- (+) `AnonymousState` **obs**
- (+) `NextState` **obs**