This project is a PAL (programmable array logic device). It is programmed with a shift register.
Because I do not want to update the text below too often I write the configuration of the physical PAL device in terms of:
There was a really convenient picture that unfortunatly I cannot include in the generated documentation. However if you check out the github repo of this project you can study it. It shows how the inputs, intermediate stages and output stages correlate to each other. Basically there is a matrix of inputs (N) and intermediate stages (P) with the size N*P. In the picture you can see numbers at the intersections of inputs/intermediate/output wires, which denote the indices of the shift register chain at this postion. The generated bitstream has a '1' at this positions if a connection is set and a '0' if no connection is set.
uio_in wires.uio_in[1] pin.uio_in[2]uio_in[0]. Aka here the bitstream is fed into - bit by bit!uo_out[3:0] bits.uio_in[2] pin.At every rising edge of the programming-clock the shift register takes in a value from the config_bit pin. When the configuration is done the PAL implements the programmed combinatorial function(s). However in order to get the programmed function(s) to generate outputs the enable pin has to be asserted.
To generate bitstreams for the shift register a Python script is provided in this repository.
It is important to set the right number of inputs, intermediate stages and outputs.
This has to be exactly like the physical PAL-device you have at hand.
A boolean logic function is denoted in the following way:
O0 = ~I0 | I1 & ~(I2 & I3)
It is important to declare the used variables before. See the Python script as it was done for O0, I1, I2, I3.
You can add or remove variables. However keep in mind that the physical number of variables is limited.
You can check the physical number that will be on the device in the project.v file.
At this point in time the bitstream generation in the Python script has some of limitations.
Okay now that you have transmitted the bitstream onto the PALs shift register you can set the enable pin (uio-pin) to output the programmed logic functions on the outputs.
By first shifting in a bitstream configuration into the device the AND/OR matrix of the device can be programmed to implement boolean functions with a set of inputs and outputs. You can test the design by clocking in a bitstream with a microcontroller (I will provide some example code for that) and by connecting buttons to the inputs and maybe LEDs to the outputs.
No external HW is needed. However to see your glorious boolean functions come to life you might want to connect some switches to the inputs and LEDs to the outputs.
| # | Input | Output | Bidirectional |
|---|---|---|---|
| 0 | Combinatorial input 0 | Combinatorial output 0 | Config pin: This pin is used to apply the config bit that will be shifted in on a rising clock edge. |
| 1 | Combinatorial input 1 | Combinatorial output 1 | Enable pin: If HIGH (1) the result of the logic function is applied to all outputs. |
| 2 | Combinatorial input 2 | Combinatorial output 2 | Clock pin: Used for the shift register to sample in the [config pin] data (see uio[0]). |
| 3 | Combinatorial input 3 | Combinatorial output 3 | unused |
| 4 | Combinatorial input 4 | Combinatorial output 3 | unused |
| 5 | Combinatorial input 5 | unused - tied to 0 | unused |
| 6 | Combinatorial input 6 | unused - tied to 0 | unused |
| 7 | Combinatorial input 7 | unused - tied to 0 | unused |