Doc improved

README.md

@@ -789,11 +789,10 @@ Below, the sub-configurations are listed and explained.
     - "1": disables refreshes
     - "0": normal operation (refreshes enabled)
   - ControllerCoreRefMode (unsigned int)
-    - Refresh mode. 1: 1X, 2: 2X, 4: 4X. Refresh period is tREFI, tREFI/2, tREFI/4, respectively. Number of rows per refresh affected accordingly.
+    - Refresh mode. 1: 1X, 2: 2X, 4: 4X. Refresh period is tREFI, tREFI/2,
-	The default refresh mode is fixed 1X mode where Refresh commands should be issued with the normal rate, i.e., tREFI. The duration of each refresh command is the normal refresh cycle time tRFC.
+      tREFI/4, respectively. Number of rows per refresh is affected. Maximum
-	In 2X mode Refresh commands are issued to the DRAM at the double frequency (tREFI/2).
+      values for pull-in and postpone affected. There is a refresh cycle time
-	In 4X mode Refresh commands are issued to the DRAM at the quadruple frequency (tREFI/4).
+      tRFC for each mode that comes from the memory specification.
-	There is a tRFC value for each mode that comes from the memory specification.
   - *ControllerCoreRefForceMaxPostponeBurst* (boolean)
     - "1": always postpone, resulting in a ControllerCoreRefMaxPostponed burst
     - "0": normal operation
@@ -804,9 +803,9 @@ Below, the sub-configurations are listed and explained.
     - "1": enables the pull-in refresh feature
     - "0": normal operation
   - *ControllerCoreRefMaxPostponed* (unsigned int)
-    - Max AR commands to be postponed. Refresh mode affects this config (multiplier).
+    - Max AR commands to be postponed. Refresh mode affects this config.
   - *ControllerCoreRefMaxPulledIn* (unsigned int)
-    - Max AR commands to be pulled-in. Refresh mode affects this config (multiplier).
+    - Max AR commands to be pulled-in. Refresh mode affects this config.
   - *ControllerCoreRGR* (boolean)
     - "1": enables row granular refresh feature (RGR)
     - "0": normal operation
@@ -877,10 +876,26 @@ Below, the sub-configurations are listed and explained.
     - Timing can be changed to explore optimum row granular refresh (ORGR)
 
 
-- **Flexible Refresh**
+** Refresh modes **
 
-The feature can be used together with regular refresh and also with row
+Currently the refresh modes available are 1X, 2X, 4X. The default refresh mode
-granular refresh (RGR).
+is fixed 1X mode where refresh commands should be issued with the normal rate,
+i.e., tREFI. The duration of each refresh command is the normal refresh cycle
+time tRFC. In 2X mode Refresh commands are issued to the DRAM at the double
+frequency (tREFI/2). In 4X mode Refresh commands are issued to the DRAM at the
+quadruple frequency (tREFI/4). There is a tRFC value for each mode that comes
+from the memory specification.
+
+The number of refresh commands in a tREFI is multiplied by two in 2X mode and
+by four in 4X mode. The maximum number of refresh commands that can be
+postponed or pulled-in is affected in the same manner. The number of rows per
+refresh command is divided by two and by four in 2X and 4X mode respectively.
+
+**Flexible Refresh**
+
+The feature can be used together with regular refresh, bankwise refresh and
+also with row granular refresh (RGR) non-bankwise and bankwise. Combinations
+with all refresh modes are possible.
 
 **Pull-In Refresh**