Merge branch 'master' of https://github.com/JulienOury/ChristmasTreeController
diff --git a/.github/workflows/user_project_ci.yml b/.github/workflows/user_project_ci.yml
index b09bda5..3d7af05 100644
--- a/.github/workflows/user_project_ci.yml
+++ b/.github/workflows/user_project_ci.yml
@@ -140,9 +140,9 @@
         run: |
           make verify-step_motor_controller-rtl 
 
-      - name: Run DV RTL test -> string_led_controller_tb
+      - name: Run DV RTL test -> string_led_controller
         run: |
-          make verify-string_led_controller_tb-rtl 
+          make verify-string_led_controller-rtl 
 
       - name: Run DV GL test -> pseudorandom
         run: |
@@ -156,7 +156,7 @@
         run: |
           make verify-step_motor_controller-gl 
 
-      - name: Run DV GL test -> string_led_controller_tb
+      - name: Run DV GL test -> string_led_controller
         run: |
-          make verify-string_led_controller_tb-gl 
+          make verify-string_led_controller-gl 
 
diff --git a/README.md b/README.md
index a0664c4..e699eec 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,38 @@
-# Christmas tree controller
-
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![UPRJ_CI](https://github.com/JulienOury/ChristmasTreeController/actions/workflows/user_project_ci.yml/badge.svg)](https://github.com/JulienOury/ChristmasTreeController/actions/workflows/user_project_ci.yml)
 
-A Christmas tree controller that include  :
+# Christmas tree controller (ASIC)
+
+This project implements a Christmas tree controller that include four dedicated modules :
  - Infrared receiver (protocol NEC)
  - StepMotor controller (full-step, half-step, with strenght control)
  - Led string controller (compatibles WS2812B)
- - Pseudo-rendom generator (32bits)
+ - Pseudo-random generator (32bits)
+
+
+### Architecture
+
+This design is based on following [Caravel user project](https://github.com/efabless/caravel_user_project.git) template.
+
+Below is a representation of the architecture:
+
+![multi macro](pictures/soc_architecture.png)
+
+
+### Memory mapping
+
+The Wishbone bus address mapping below :
+
+| ADDRESS | DESCRIPTION |
+| ------ | ------ |
+| 0x30000000 | NEC IR receiver |
+| 0x30010000 | PseudoRandom generator |
+| 0x30020000 | Step motor controller |
+| 0x30030000 | String Led controller |
+
+
+### ASIC layout
+
+Below is a representation of the ASIC layout:
+
+![multi macro](pictures/layout.png)