Skip to content

Commit

Permalink
fix readmes
Browse files Browse the repository at this point in the history
  • Loading branch information
gadfort committed Aug 17, 2024
1 parent caee57c commit d23c2ac
Show file tree
Hide file tree
Showing 3 changed files with 17 additions and 21 deletions.
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@ Lambdalib includes the following hardware categories:
|[stdlib](lambdalib/stdlib/rtl) | Standard cells (inv, nand, ff, ...)
|[auxlib](lambdalib/auxlib/rtl) | Aux cells can consist of multiple standard cells or physical only cells
|[ramlib](lambdalib/ramlib/rtl) | Memory (single port, dual port, fifo, ...)
|[iolib](lambdalib/iolib/rtl) | IO cells (bidir, vdd, clamp,...)
|[padring](lambdalib/padring/rtl) | Padring generator
|[iolib](lambdalib/iolib) | IO cells (bidir, vdd, clamp,...)
|[padring](lambdalib/padring) | Padring generator
|[vectorlib](lambdalib/vectorlib/rtl) | Vectorized library (mux, isolation)
|[syslib](lambdalib/syslib/rtl) | Vendor agnostic peripheral interface (uart, i2c,...)
|[fpgalib](lambdalib/fpgalib/rtl) | FPGA cells (lut4, ble, clb)
Expand Down
4 changes: 2 additions & 2 deletions lambdalib/iolib/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

| Cell | Type | Description |
| ---------------------------------|---------|-----------------------------|
[[la_iobidir](./rtl/la_iobidir.v) | Digital | Bidirectional
[la_iobidir](./rtl/la_iobidir.v) | Digital | Bidirectional
[la_ioinput](./rtl/la_ioinput.v) | Digital | Input
[la_ioxtal](./rtl/la_ioxtal.v) | Digital | Xtal transceiver
[la_iorxdiff](./rtl/la_iorxdiff.v) | Digital | Differential input
Expand Down Expand Up @@ -77,4 +77,4 @@ The `PROP` parameter can be used by the technology specific `iolib` implementati

## la_ioclamp

## la_iocut
## la_iocut
30 changes: 13 additions & 17 deletions lambdalib/padring/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Introduction

The lamdbdalib `padring` library is an automated "pure verilog" padring generator with support for cells within the [IOLIB](../../iolib/README.md) io cell library.
The lamdbdalib `padring` library is an automated "pure verilog" padring generator with support for cells within the [IOLIB](../iolib/README.md) io cell library.

## PARAMETERS

Expand All @@ -20,17 +20,17 @@ Specifies the type of cells, pin connections, properties, and power connections

* PIN[7:0] = CELLMAP[7:0] = pin number connected to cell. Positive signal in case of differential pairs.
* COMP[7:0] = CELLMAP[15:8] = pin number of complementary (negative) pad to `PIN`. Used for differential IO cells.
* TYPE[7:0] = CELLMAP[23:16] = cell type (see ./la_padring.vh)
* TYPE[7:0] = CELLMAP[23:16] = cell type (see [la_iopadring.vh](rtl/la_iopadring.vh))
* SECTION[7:0] = CELLMAP[31:24] = padring power section number connected to cell
* PROP[7:0] = CELLMAP[39:32] = property passed to technology specific iolib implementation

The header file [la_iopadring.vh](./rtl/la_iopadring.vh) enumerates the cells recognized by the padring generator. `NULL` is a reserved keyword used to specify an empty `CELLMAP` field.
The header file [la_iopadring.vh](rtl/la_iopadring.vh) enumerates the cells recognized by the padring generator. `NULL` is a reserved keyword used to specify an empty `CELLMAP` field.

### CFGW
Specifies the width of the configuration bus of the io cell. For a description of uses of `CFGW`, see [IOLIB](../../iolib/README.md).
Specifies the width of the configuration bus of the io cell. For a description of uses of `CFGW`, see [IOLIB](../iolib/README.md).

#### RINGW
The `RINGW` parameter specifies the number of signals within the power bus that connects all of the io cells together within the padring. For a description of uses of `RINGW`, see [IOLIB](../../iolib/README.md).
The `RINGW` parameter specifies the number of signals within the power bus that connects all of the io cells together within the padring. For a description of uses of `RINGW`, see [IOLIB](../iolib/README.md).


## Using the Generator
Expand All @@ -50,7 +50,6 @@ The following excerpt from the testbench illustrate the use of the `CELLMAP`, `N

```verilog
// Setting up your parameters
localparam CFGW = 8;
Expand All @@ -65,16 +64,16 @@ The following excerpt from the testbench illustrate the use of the `CELLMAP`, `N
localparam [7:0] PIN_RXP = 8'h02;
localparam [7:0] PIN_RXN = 8'h03;
localparam NULL = 8'h0;
localparam [7:0] NULL = 8'h0;
localparam CELLMAP = {{NULL, NULL, LA_VSS, NULL, NULL},
{NULL, NULL, LA_BIDIR, NULL, PIN_IO0},
{NULL, NULL, LA_ANALOG, NULL, PIN_AN0},
{NULL, NULL, LA_VDDIO, NULL, NULL},
{NULL, NULL, LA_RXDIFF, PIN_RXN, PIN_RXP},
{NULL, NULL, LA_VSS, NULL, NULL},
{NULL, NULL, LA_VSS, NULL, NULL},
{NULL, NULL, LA_VSS, NULL, NULL}};
{NULL, NULL, LA_BIDIR, NULL, PIN_IO0},
{NULL, NULL, LA_ANALOG, NULL, PIN_AN0},
{NULL, NULL, LA_VDDIO, NULL, NULL},
{NULL, NULL, LA_RXDIFF, PIN_RXN, PIN_RXP},
{NULL, NULL, LA_VSS, NULL, NULL},
{NULL, NULL, LA_VSS, NULL, NULL},
{NULL, NULL, LA_VSS, NULL, NULL}};
// Instantiating the padring in your design
la_iopadring #(.CFGW(CFGW),
Expand All @@ -92,7 +91,4 @@ la_iopadring #(.CFGW(CFGW),
.WE_CELLMAP(CELLMAP),
.SO_CELLMAP(CELLMAP))
la_iopadring(...)
```

0 comments on commit d23c2ac

Please sign in to comment.