From 96c234de6d858472cf2736115f91275b7ec3d417 Mon Sep 17 00:00:00 2001
From: Gamenight77 <game.night.77176@gmail.com>
Date: Mon, 28 Apr 2025 17:13:39 +0200
Subject: [PATCH] Add UART communication modules and testbenches

- Implemented rx_fifo module for receiving data with FIFO management.
- Created tb_top_uart_rx_tx testbench for testing UART transmission and reception.
- Developed tb_uart_rx testbench for validating UART receiver functionality.
- Added tb_uart_tx testbench for testing UART transmitter behavior.
- Designed top_led_uart module to interface UART with LED outputs.
- Integrated top_uart_ultrasonic module for ultrasonic sensor data transmission via UART.
- Implemented tx_fifo module for transmitting data with FIFO management.
- Developed uart_rx module for receiving serial data with state machine control.
- Created uart_top module to connect RX and TX functionalities with FIFO buffers.
- Implemented uart_tx module for transmitting serial data with state machine control.
---
 Semaine_3/UARTV2/memo.png              | Bin 0 -> 63083 bytes
 Semaine_3/UARTV2/rx_fifo.v             |  49 +++++++++
 Semaine_3/UARTV2/tb_top_uart_rx_tx.v   |  69 ++++++++++++
 Semaine_3/UARTV2/tb_uart_rx.v          |  64 +++++++++++
 Semaine_3/UARTV2/tb_uart_tx.v          |  49 +++++++++
 Semaine_3/UARTV2/top_led_uart.v        |  61 +++++++++++
 Semaine_3/UARTV2/top_uart_ultrasonic.v | 133 +++++++++++++++++++++++
 Semaine_3/UARTV2/tx_fifo.v             |  57 ++++++++++
 Semaine_3/UARTV2/uart_rx.v             | 145 +++++++++++++++++++++++++
 Semaine_3/UARTV2/uart_top.v            |  86 +++++++++++++++
 Semaine_3/UARTV2/uart_tx.v             | 133 +++++++++++++++++++++++
 11 files changed, 846 insertions(+)
 create mode 100644 Semaine_3/UARTV2/memo.png
 create mode 100644 Semaine_3/UARTV2/rx_fifo.v
 create mode 100644 Semaine_3/UARTV2/tb_top_uart_rx_tx.v
 create mode 100644 Semaine_3/UARTV2/tb_uart_rx.v
 create mode 100644 Semaine_3/UARTV2/tb_uart_tx.v
 create mode 100644 Semaine_3/UARTV2/top_led_uart.v
 create mode 100644 Semaine_3/UARTV2/top_uart_ultrasonic.v
 create mode 100644 Semaine_3/UARTV2/tx_fifo.v
 create mode 100644 Semaine_3/UARTV2/uart_rx.v
 create mode 100644 Semaine_3/UARTV2/uart_top.v
 create mode 100644 Semaine_3/UARTV2/uart_tx.v

diff --git a/Semaine_3/UARTV2/memo.png b/Semaine_3/UARTV2/memo.png
new file mode 100644
index 0000000000000000000000000000000000000000..87b7ec1d941d930e8f886bd8f54e683b8c3fd520
GIT binary patch
literal 63083
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

literal 0
HcmV?d00001

diff --git a/Semaine_3/UARTV2/rx_fifo.v b/Semaine_3/UARTV2/rx_fifo.v
new file mode 100644
index 0000000..e442fe9
--- /dev/null
+++ b/Semaine_3/UARTV2/rx_fifo.v
@@ -0,0 +1,49 @@
+module rx_fifo #(
+    parameter WIDTH = 8, // Taille des données (8 bits)
+    parameter DEPTH = 16 // Taille de la FIFO
+)(
+    input clk,
+    input rst_p,
+    input [WIDTH-1:0] rx_data_in,
+    input rx_data_valid,  // Indique que les données reçues sont valides
+    output reg [WIDTH-1:0] rx_data_out,
+    output reg rx_data_ready,  // Indique que les données peuvent être lues
+    output reg fifo_empty,     // FIFO vide
+    output reg fifo_full       // FIFO pleine
+);
+
+    reg [WIDTH-1:0] fifo_mem [DEPTH-1:0];  // Mémoire FIFO
+    reg [4:0] wr_ptr = 0;  // Pointeur d'écriture
+    reg [4:0] rd_ptr = 0;  // Pointeur de lecture
+    reg [4:0] fifo_count = 0; // Compteur d'éléments dans la FIFO
+
+    always @(posedge clk or posedge rst_p) begin
+        if (rst_p) begin
+            wr_ptr <= 0;
+            rd_ptr <= 0;
+            fifo_count <= 0;
+            rx_data_ready <= 0;
+            fifo_empty <= 1;
+            fifo_full <= 0;
+        end else begin
+            // Écriture dans la FIFO
+            if (rx_data_valid && !fifo_full) begin
+                fifo_mem[wr_ptr] <= rx_data_in;
+                wr_ptr <= wr_ptr + 1;
+                fifo_count <= fifo_count + 1;
+            end
+
+            // Lecture de la FIFO
+            if (!fifo_empty) begin
+                rx_data_out <= fifo_mem[rd_ptr];
+                rd_ptr <= rd_ptr + 1;
+                fifo_count <= fifo_count - 1;
+            end
+
+            // Mise à jour des indicateurs de vide et de plein
+            fifo_empty <= (fifo_count == 0);
+            fifo_full <= (fifo_count == DEPTH);
+            rx_data_ready <= !fifo_empty;
+        end
+    end
+endmodule
diff --git a/Semaine_3/UARTV2/tb_top_uart_rx_tx.v b/Semaine_3/UARTV2/tb_top_uart_rx_tx.v
new file mode 100644
index 0000000..6c9dc52
--- /dev/null
+++ b/Semaine_3/UARTV2/tb_top_uart_rx_tx.v
@@ -0,0 +1,69 @@
+`timescale 1ns / 1ps
+
+module tb_top_uart_rx_tx;
+
+    parameter CLK_FREQ = 27_000_000;
+    parameter BAUD_RATE = 115200;
+
+    // Signaux
+    reg clk = 0;
+    reg start = 0;
+    reg [7:0] data_in = 0;
+    wire [7:0] data_out;
+    wire valid;
+    wire tx;
+    wire rx;  // On connecte tx directement à rx pour le test
+
+    // Instance du module à tester
+    top_uart_rx_tx #(
+        .CLK_FREQ(CLK_FREQ),
+        .BAUD_RATE(BAUD_RATE)
+    ) uut (
+        .clk(clk),
+        .start(start),
+        .data_in(data_in),
+        .rx(rx),
+        .data_out(data_out),
+        .valid(valid),
+        .tx(tx)
+    );
+
+    // Boucle le tx sur rx
+    assign rx = tx;
+
+    // Clock à 50 MHz (20 ns période)
+    always #10 clk = ~clk;
+
+    // Simulation principale
+    initial begin
+        $display("Début de la simulation");
+        $dumpfile("uart_loopback.vcd"); // Pour GTKWave
+        $dumpvars(0, tb_top_uart_rx_tx);
+
+        // Attendre un peu
+        #(20 * 10);
+
+        // Envoi d'une valeur
+        data_in = 8'hA5;  // Exemple de data
+        start = 1;
+        #20;
+        start = 0;
+
+        // Attendre la réception (valeur valid = 1)
+        wait(valid == 1);
+
+        // Affichage des résultats
+        $display("Data envoyee : 0x%h", data_in);
+        $display("Data recue   : 0x%h", data_out);
+
+        if (data_out == data_in)
+            $display("Test reussi !");
+        else
+            $display("Test echoue...");
+
+        // Fin de simulation
+        #(20 * 10);
+        $finish;
+    end
+
+endmodule
\ No newline at end of file
diff --git a/Semaine_3/UARTV2/tb_uart_rx.v b/Semaine_3/UARTV2/tb_uart_rx.v
new file mode 100644
index 0000000..874dfd7
--- /dev/null
+++ b/Semaine_3/UARTV2/tb_uart_rx.v
@@ -0,0 +1,64 @@
+`timescale 1ns / 1ps
+
+module tb_uart_rx;
+
+    reg clk = 0;
+    reg rx = 1;  
+    wire [7:0] data;
+    wire valid;
+    wire ready;
+
+    localparam CLK_FREQ = 27_000_000;
+    localparam BAUD_RATE = 115_200;
+    localparam BIT_PERIOD = CLK_FREQ / BAUD_RATE; 
+    localparam CLK_PERIOD_NS = 1000000000 / CLK_FREQ; 
+
+    uart_rx #(
+        .CLK_FREQ(CLK_FREQ),
+        .BAUD_RATE(BAUD_RATE)
+    ) rx_instance (
+        .clk(clk),
+        .rx(rx),
+        .data(data),
+        .valid(valid),
+        .ready(ready)
+    );
+
+    always #(CLK_PERIOD_NS/2) clk = ~clk;
+
+    task send_bit(input reg b);
+        begin
+            rx <= b;
+            #(BIT_PERIOD * CLK_PERIOD_NS); 
+        end
+    endtask
+
+    integer i;
+
+    task send_byte(input [7:0] byte);
+        begin
+            send_bit(0); 
+            for (i = 0; i < 8; i = i + 1)
+                send_bit(byte[i]); 
+            send_bit(1); 
+            
+            #(BIT_PERIOD * CLK_PERIOD_NS);
+        end
+    endtask
+
+    initial begin
+        $display("Start UART RX test");
+        #100; 
+
+        send_byte(8'b01010101); 
+
+        #(10 * BIT_PERIOD * CLK_PERIOD_NS);
+
+        if (valid && data == 8'b01010101)
+            $display("Test ok : data = %b", data);
+        else
+            $display("Test pas ok : data = %b, valid = %b", data, valid);
+
+        $finish;
+    end
+endmodule
diff --git a/Semaine_3/UARTV2/tb_uart_tx.v b/Semaine_3/UARTV2/tb_uart_tx.v
new file mode 100644
index 0000000..4c1fe2d
--- /dev/null
+++ b/Semaine_3/UARTV2/tb_uart_tx.v
@@ -0,0 +1,49 @@
+`timescale 1ns/1ps
+
+module tb_uart_tx;
+
+    reg clk = 0;
+    reg start = 0;
+    reg [7:0] data = 8'h00;
+    wire tx;
+    wire busy;
+
+    always #18.5 clk = ~clk;
+
+    uart_tx #(
+        .CLK_FREQ(27_000_000),
+        .BAUD_RATE(115_200)
+    )tx_instance (
+        .clk(clk),
+        .start(start),
+        .data(data),
+        .tx(tx),
+        .busy(busy)
+    );
+
+    initial begin
+        $dumpfile("uart_tx.vcd");
+        $dumpvars(0, tb_uart_tx);
+
+        #100;
+
+        data <= 8'hA5;   // 10100101 0xA5
+        start <= 1;
+        #37 start <= 0; 
+
+        // Attendre
+        wait (busy == 0);
+
+        #1000;
+
+        data <= 8'h3C;   // 00111100  0x3C
+        start <= 1;
+        #37 start <= 0;
+
+        wait (busy == 0);
+
+        #1000;
+        $stop;
+    end
+
+endmodule
\ No newline at end of file
diff --git a/Semaine_3/UARTV2/top_led_uart.v b/Semaine_3/UARTV2/top_led_uart.v
new file mode 100644
index 0000000..6db1633
--- /dev/null
+++ b/Semaine_3/UARTV2/top_led_uart.v
@@ -0,0 +1,61 @@
+module top_led_uart(
+    input wire clk,
+    input wire rx,
+    output wire tx,
+    output reg [5:0] leds
+);
+    wire [7:0] data_out;
+    wire valid;
+    reg start_tx = 0;
+    reg [7:0] data_in = 0;
+
+    uart_top uart (
+        .clk(clk),
+        .start(start_tx),
+        .data_in(data_in),
+        .rx(rx),
+        .data_out(data_out),
+        .valid(valid),
+        .tx(tx)
+    );
+
+    reg [1:0] state = 0;
+    localparam IDLE = 2'd0;
+    localparam TOGGLE = 2'd1;
+    localparam SEND_BACK = 2'd2;
+
+    always @(posedge clk) begin
+        case (state)
+            INIT: begin
+                leds <= 6'b000000; 
+                start_tx <= 0;
+                if (valid) begin
+                    
+                    leds <= data_out[5:0];
+                    state <= SEND_BACK;
+                    
+                end
+            end
+            IDLE: begin
+                start_tx <= 0;
+                if (valid) begin
+                    
+                    leds <= data_out[5:0];
+                    state <= SEND_BACK;
+                    
+                end
+            end
+
+            SEND_BACK: begin
+                data_in <= data_out;
+                start_tx <= 1;
+                state <= TOGGLE;
+            end
+
+            TOGGLE: begin
+                start_tx <= 0;
+                state <= IDLE;
+            end
+        endcase
+    end
+endmodule
diff --git a/Semaine_3/UARTV2/top_uart_ultrasonic.v b/Semaine_3/UARTV2/top_uart_ultrasonic.v
new file mode 100644
index 0000000..5ef3d60
--- /dev/null
+++ b/Semaine_3/UARTV2/top_uart_ultrasonic.v
@@ -0,0 +1,133 @@
+module top_uart_ultrasonic (
+    input wire clk,
+    input wire rst_p,
+    input wire start,        // Démarrage de la mesure
+    inout wire sig,          // Signal vers le capteur ultrason
+    output wire uart_tx      // TX vers le PC
+);
+    wire [15:0] distance;
+    wire [2:0] state;
+    
+    reg [7:0] tx_data_in;
+    reg tx_data_valid;
+    wire tx_data_ready;
+    wire fifo_empty;
+    wire fifo_full;
+
+    wire uart_ready;
+    reg uart_start;
+    reg [7:0] uart_data;
+
+    reg [1:0] send_state;
+    localparam IDLE = 2'd0,
+               SEND_HIGH = 2'd1,
+               SEND_LOW = 2'd2,
+               WAIT_UART = 2'd3;
+    
+    // Instanciation du module ultrason
+    ultrasonic_fpga #(
+        .CLK_FREQ(27_000_000)
+    ) ultrasonic_inst (
+        .clk(clk),
+        .start(start),
+        .sig(sig),
+        .distance(distance),
+        .state(state)
+    );
+
+    // Instanciation de la FIFO
+    tx_fifo #(
+        .WIDTH(8),
+        .DEPTH(16)
+    ) fifo_inst (
+        .clk(clk),
+        .rst_p(rst_p),
+        .tx_data_in(tx_data_in),
+        .tx_data_valid(tx_data_valid),
+        .tx_data_ready(tx_data_ready),
+        .fifo_empty(fifo_empty),
+        .fifo_full(fifo_full)
+    );
+
+    // Instanciation de l'UART
+    uart_tx uart_inst (
+        .clk(clk),
+        .rst(rst_p),
+        .tx_start(uart_start),
+        .tx_data(uart_data),
+        .tx(uart_tx),
+        .tx_ready(uart_ready)
+    );
+
+    reg [15:0] distance_reg;
+    reg new_distance;
+
+    // Détecte un nouveau résultat de distance
+    always @(posedge clk or posedge rst_p) begin
+        if (rst_p) begin
+            distance_reg <= 16'd0;
+            new_distance <= 1'b0;
+        end else begin
+            if (state == 3'd6 && distance != distance_reg) begin  // Quand l'ultrason est à DONE
+                distance_reg <= distance;
+                new_distance <= 1'b1;
+            end else begin
+                new_distance <= 1'b0;
+            end
+        end
+    end
+
+    // Envoi dans la FIFO (distance sur 2 octets : high byte + low byte)
+    always @(posedge clk or posedge rst_p) begin
+        if (rst_p) begin
+            tx_data_in <= 8'd0;
+            tx_data_valid <= 1'b0;
+            send_state <= IDLE;
+        end else begin
+            case (send_state)
+                IDLE: begin
+                    tx_data_valid <= 1'b0;
+                    if (new_distance && !fifo_full) begin
+                        tx_data_in <= distance_reg[15:8];  // MSB en premier
+                        tx_data_valid <= 1'b1;
+                        send_state <= SEND_LOW;
+                    end
+                end
+
+                SEND_LOW: begin
+                    tx_data_valid <= 1'b0;
+                    if (tx_data_ready && !fifo_full) begin
+                        tx_data_in <= distance_reg[7:0];   // LSB ensuite
+                        tx_data_valid <= 1'b1;
+                        send_state <= WAIT_UART;
+                    end
+                end
+
+                WAIT_UART: begin
+                    tx_data_valid <= 1'b0;
+                    send_state <= IDLE;
+                end
+
+                default: send_state <= IDLE;
+            endcase
+        end
+    end
+
+    // Gestion FIFO -> UART
+    always @(posedge clk or posedge rst_p) begin
+        if (rst_p) begin
+            uart_start <= 1'b0;
+            uart_data <= 8'd0;
+        end else begin
+            uart_start <= 1'b0; // Par défaut
+
+            if (uart_ready && !fifo_empty) begin
+                uart_data <= fifo_inst.fifo_mem[fifo_inst.rd_ptr]; // Lecture de la FIFO
+                uart_start <= 1'b1;
+                fifo_inst.rd_ptr <= fifo_inst.rd_ptr + 1;
+                fifo_inst.fifo_count <= fifo_inst.fifo_count - 1;
+            end
+        end
+    end
+
+endmodule
diff --git a/Semaine_3/UARTV2/tx_fifo.v b/Semaine_3/UARTV2/tx_fifo.v
new file mode 100644
index 0000000..80ff502
--- /dev/null
+++ b/Semaine_3/UARTV2/tx_fifo.v
@@ -0,0 +1,57 @@
+module tx_fifo #(
+    parameter WIDTH = 8,  // Taille des données (8 bits)
+    parameter DEPTH = 16  // Taille de la FIFO
+)(
+    input wire clk,
+    input wire rst_p,
+
+    // Entrée utilisateur
+    input  wire [WIDTH-1:0] tx_data_in,
+    input  wire             tx_data_valid,  // Donnée disponible à écrire
+    output wire             tx_data_ready,  // FIFO prête à recevoir
+
+    // Sortie vers UART
+    output reg  [WIDTH-1:0] tx_data_out,
+    input  wire             uart_tx_ready,  // UART demande une donnée
+    output reg              fifo_empty,     
+    output reg              fifo_full
+);
+
+    reg [WIDTH-1:0] fifo_mem [DEPTH-1:0];
+    reg [4:0] wr_ptr = 0;
+    reg [4:0] rd_ptr = 0;
+    reg [4:0] fifo_count = 0;
+
+    always @(posedge clk or posedge rst_p) begin
+        if (rst_p) begin
+            wr_ptr <= 0;
+            rd_ptr <= 0;
+            fifo_count <= 0;
+            fifo_empty <= 1;
+            fifo_full <= 0;
+            tx_data_out <= 0;
+        end else begin
+            // Écriture dans FIFO
+            if (tx_data_valid && !fifo_full) begin
+                fifo_mem[wr_ptr] <= tx_data_in;
+                wr_ptr <= wr_ptr + 1;
+                fifo_count <= fifo_count + 1;
+            end
+
+            // Lecture depuis FIFO
+            if (uart_tx_ready && !fifo_empty) begin
+                tx_data_out <= fifo_mem[rd_ptr];
+                rd_ptr <= rd_ptr + 1;
+                fifo_count <= fifo_count - 1;
+            end
+
+            // Mise à jour des flags
+            fifo_empty <= (fifo_count == 0);
+            fifo_full  <= (fifo_count == DEPTH);
+        end
+    end
+
+    // FIFO est prête à recevoir des données si pas pleine
+    assign tx_data_ready = !fifo_full;
+
+endmodule
diff --git a/Semaine_3/UARTV2/uart_rx.v b/Semaine_3/UARTV2/uart_rx.v
new file mode 100644
index 0000000..278ee7c
--- /dev/null
+++ b/Semaine_3/UARTV2/uart_rx.v
@@ -0,0 +1,145 @@
+module uart_rx #(
+	parameter CLK_FREQ = 27_000_000,
+	parameter BAUD_RATE = 115200
+)(
+	input                        clk,               //clock input
+	input                        rst_p,             //asynchronous reset input, high active 
+	input                        rx_data_ready,     //data receiver module ready
+	input                        rx_pin,             //serial data input
+
+    output reg[7:0]              rx_data,           //received serial data
+	output reg                   rx_data_valid     //received serial data is valid
+);
+ 
+localparam                       CYCLE = CLK_FREQ * / BAUD_RATE;
+
+//state machine code
+localparam                       S_IDLE      = 1;
+localparam                       S_START     = 2;   //start bit
+localparam                       S_REC_BYTE  = 3;   //data bits
+localparam                       S_STOP      = 4;   //stop bit
+localparam                       S_DATA      = 5;
+
+reg[2:0]                         state;
+reg[2:0]                         next_state;
+
+reg                              rx_d0;             //delay 1 clock for rx_pin
+reg                              rx_d1;             //delay 1 clock for rx_d0
+wire                             rx_negedge;        //negedge of rx_pin
+reg[7:0]                         rx_bits;           //temporary storage of received data
+reg[15:0]                        cycle_cnt;         //baud counter
+reg[2:0]                         bit_cnt;           //bit counter
+
+assign rx_negedge = rx_d1 && ~rx_d0;    // Front déscendant
+
+always@(posedge clk or negedge rst_p)   // Filtrage du signial
+begin
+	if(rst_p == 1'b1)begin
+		rx_d0 <= 1'b0;
+		rx_d1 <= 1'b0;	
+        
+	end else begin
+		rx_d0 <= rx_pin;
+		rx_d1 <= rx_d0;
+	end
+end
+
+
+always@(posedge clk or negedge rst_p)begin  // Compteur d'etat
+	if(rst_p == 1'b1)
+		state <= S_IDLE;
+	else
+		state <= next_state;
+end
+
+always@(*)begin
+	case(state)
+		S_IDLE:
+			if(rx_negedge)                  // Detection du start bit
+				next_state = S_START;
+			else
+				next_state = S_IDLE;
+
+		S_START:
+			if(cycle_cnt == CYCLE - 1)      //one data cycle 
+				next_state = S_REC_BYTE;
+			else
+				next_state = S_START;
+
+		S_REC_BYTE:
+			if(cycle_cnt == CYCLE - 1  && bit_cnt == 3'd7)  //receive 8bit data
+				next_state = S_STOP;
+			else
+				next_state = S_REC_BYTE;
+
+		S_STOP:
+			if(cycle_cnt == CYCLE/2 - 1)    //half bit cycle,to avoid missing the next byte receiver
+				next_state = S_DATA;
+			else
+				next_state = S_STOP;
+
+		S_DATA:
+			if(rx_data_ready)               //data receive complete
+				next_state = S_IDLE;
+			else
+				next_state = S_DATA;
+
+		default:
+			next_state = S_IDLE;
+	endcase
+end
+
+always@(posedge clk or negedge rst_p)
+begin
+	if(rst_p == 1'b1)
+		rx_data_valid <= 1'b0;
+	else if(state == S_STOP && next_state != state)
+		rx_data_valid <= 1'b1;
+	else if(state == S_DATA && rx_data_ready)
+		rx_data_valid <= 1'b0;
+end
+
+always@(posedge clk or negedge rst_p)
+begin
+	if(rst_p == 1'b1)
+		rx_data <= 8'd0;
+	else if(state == S_STOP && next_state != state)
+		rx_data <= rx_bits;//latch received data
+end
+
+always@(posedge clk or negedge rst_p)
+begin
+	if(rst_p == 1'b1)
+		begin
+			bit_cnt <= 3'd0;
+		end
+	else if(state == S_REC_BYTE)
+		if(cycle_cnt == CYCLE - 1)
+			bit_cnt <= bit_cnt + 3'd1;
+		else
+			bit_cnt <= bit_cnt;
+	else
+		bit_cnt <= 3'd0;
+end
+
+
+always@(posedge clk or negedge rst_p)
+begin
+	if(rst_p == 1'b1)
+		cycle_cnt <= 16'd0;
+	else if((state == S_REC_BYTE && cycle_cnt == CYCLE - 1) || next_state != state)
+		cycle_cnt <= 16'd0;
+	else
+		cycle_cnt <= cycle_cnt + 16'd1;	
+end
+//receive serial data bit data
+always@(posedge clk or negedge rst_p)
+begin
+	if(rst_p == 1'b1)
+		rx_bits <= 8'd0;
+	else if(state == S_REC_BYTE && cycle_cnt == CYCLE/2 - 1)
+		rx_bits[bit_cnt] <= rx_pin;
+	else
+		rx_bits <= rx_bits; 
+end
+endmodule 
\ No newline at end of file
diff --git a/Semaine_3/UARTV2/uart_top.v b/Semaine_3/UARTV2/uart_top.v
new file mode 100644
index 0000000..ac9739e
--- /dev/null
+++ b/Semaine_3/UARTV2/uart_top.v
@@ -0,0 +1,86 @@
+module uart_top(
+    input  wire       clk,
+    input  wire       rst,
+    
+    input  wire       uart_rx,
+    output wire       uart_tx,
+    
+    // Interfaces RX vers utilisateur
+    output wire [7:0] rx_data,
+    output wire       rx_data_valid,
+    input  wire       rx_data_ready,
+
+    // Interfaces TX depuis utilisateur
+    input  wire [7:0] tx_data,
+    input  wire       tx_data_valid,
+    output wire       tx_data_ready
+);
+
+    parameter CLK_FRE  = 27_000_000; // Hz
+    parameter UART_FRE = 115200;     // Baudrate
+
+    // === Signaux internes ===
+    wire [7:0] uart_rx_data;
+    wire       uart_rx_data_valid;
+    wire       uart_rx_data_ready;
+
+    wire [7:0] uart_tx_data;
+    wire       uart_tx_data_valid;
+    wire       uart_tx_data_ready;
+
+    // === FIFO RX ===
+    rx_fifo #(
+        .WIDTH(8),
+        .DEPTH(16)
+    ) rx_fifo_inst (
+        .clk            (clk),
+        .rst_p          (rst),
+        .rx_data_in     (uart_rx_data),
+        .rx_data_valid  (uart_rx_data_valid),
+        .rx_data_out    (rx_data),
+        .rx_data_ready  (rx_data_ready),
+        .fifo_empty     (), // pas utilisé ici
+        .fifo_full      ()
+    );
+
+    // === FIFO TX ===
+    tx_fifo #(
+        .WIDTH(8),
+        .DEPTH(16)
+    ) tx_fifo_inst (
+        .clk            (clk),
+        .rst_p          (rst),
+        .tx_data_in     (tx_data),
+        .tx_data_valid  (tx_data_valid),
+        .tx_data_ready  (tx_data_ready),
+        .tx_data_out    (uart_tx_data),
+        .uart_tx_ready  (uart_tx_data_ready)
+    );
+
+    // === Instanciation RX UART ===
+    uart_rx #(
+        .CLK_FRE(CLK_FRE),
+        .BAUD_RATE(UART_FRE)
+    ) uart_rx_inst (
+        .clk           (clk),
+        .rst_p         (rst),
+        .rx_data       (uart_rx_data),
+        .rx_data_valid (uart_rx_data_valid),
+        .rx_data_ready (uart_rx_data_ready),
+        .rx_pin        (uart_rx)
+    );
+
+    // === Instanciation TX UART ===
+    uart_tx #(
+        .CLK_FRE(CLK_FRE),
+        .BAUD_RATE(UART_FRE)
+    ) uart_tx_inst (
+        .clk           (clk),
+        .rst_p         (rst),
+        .tx_data       (uart_tx_data),
+        .tx_data_valid (uart_tx_data_valid),
+        .tx_data_ready (uart_tx_data_ready),
+        .tx_pin        (uart_tx)
+    );
+
+endmodule
diff --git a/Semaine_3/UARTV2/uart_tx.v b/Semaine_3/UARTV2/uart_tx.v
new file mode 100644
index 0000000..748631e
--- /dev/null
+++ b/Semaine_3/UARTV2/uart_tx.v
@@ -0,0 +1,133 @@
+module uart_tx #(
+	parameter       CLK_FREQ = 27_000_000,
+	parameter       BAUD_RATE = 115200
+)(
+    input wire      clk,
+    input wire      rst_p,
+    input wire[7:0] data,
+    input wire      tx_data_valid,
+    
+    output wire     tx,
+    output reg      tx_data_ready
+);
+
+    localparam CYCLE = CLK_FREQ / BAUD_RATE; 
+
+    localparam IDLE  = 2'd0;
+    localparam START = 2'd1;
+    localparam DATA  = 2'd2;
+    localparam STOP  = 2'd3;
+
+    reg [1:0]   state = IDLE;
+    reg [1:0]   next_state;
+    reg [15:0]  cycle_cnt;      //baud counter
+    reg [3:0]   bit_index = 0;            
+    reg [15:0]  clk_count = 0;           
+    reg [7:0]   tx_data = 0;
+    reg         tx_reg;
+
+    assign tx = tx_reg;
+
+    always@(posedge clk or posedge rst_p)begin // Avance d'etat 
+        if(rst_p == 1'b1)
+            state <= IDLE;
+        else
+            state <= next_state;
+    end
+
+    always@(*) begin
+        case(state)
+            IDLE:
+                if(tx_data_valid == 1'b1)
+                    next_state = START;
+                else
+                    next_state = IDLE;
+
+            START:
+                if(cycle_cnt == CYCLE - 1)
+                    next_state = DATA;
+                else
+                    next_state = START;
+
+            DATA:
+                if(cycle_cnt == CYCLE - 1  && bit_cnt == 3'd7)
+                    next_state = STOP;
+                else
+                    next_state = DATA;
+
+            STOP:
+                if(cycle_cnt == CYCLE - 1)
+                    next_state = IDLE;
+                else
+                    next_state = STOP;
+            default:
+                next_state = IDLE;
+        endcase
+    end
+
+    always@(posedge clk or posedge rst_p)begin  // tx_data_ready block
+        if(rst_p == 1'b1)
+            begin
+                tx_data_ready <= 1'b0;
+            end
+
+        else if(state == IDLE)
+            if(tx_data_valid == 1'b1)
+                tx_data_ready <= 1'b0;
+            else
+                tx_data_ready <= 1'b1;
+
+        else if(state == STOP && cycle_cnt == CYCLE - 1)
+                tx_data_ready <= 1'b1;
+    end
+
+
+    always@(posedge clk or posedge rst_p) begin // tx_data_latch block
+        if(rst_p == 1'b1)begin
+                tx_data_latch <= 8'd0;
+
+        end else if(state == IDLE && tx_data_valid == 1'b1)
+                tx_data_latch <= tx_data;
+            
+    end
+
+    always@(posedge clk or posedge rst_p)begin  // DATA bit_cnt block
+        if(rst_p == 1'b1)begin
+                bit_cnt <= 3'd0;
+
+        end else if(state == DATA)
+            if(cycle_cnt == CYCLE - 1)
+                bit_cnt <= bit_cnt + 3'd1;
+            else
+                bit_cnt <= bit_cnt;
+        else
+            bit_cnt <= 3'd0;
+    end
+
+
+    always@(posedge clk or posedge rst_p)begin  // Cycle counter
+        if(rst_p == 1'b1)
+            cycle_cnt <= 16'd0;
+
+        else if((state == DATA && cycle_cnt == CYCLE - 1) || next_state != state)
+            cycle_cnt <= 16'd0;
+        else
+            cycle_cnt <= cycle_cnt + 16'd1;	
+    end
+
+    always@(posedge clk or posedge rst_p)begin  // tx state managment
+        if(rst_p == 1'b1)
+            tx_reg <= 1'b1;
+        else
+            case(state)
+                IDLE,STOP:
+                    tx_reg <= 1'b1; 
+                START:
+                    tx_reg <= 1'b0; 
+                DATA:
+                    tx_reg <= tx_data_latch[bit_cnt]; // SENDING BYTE HERE
+                default:
+                    tx_reg <= 1'b1; 
+            endcase
+    end
+endmodule