diff --git a/conf/modules/px4_flash.xml b/conf/modules/px4_flash.xml
index fd365df1e0..e48bedb4e3 100644
--- a/conf/modules/px4_flash.xml
+++ b/conf/modules/px4_flash.xml
@@ -2,7 +2,14 @@
 
 <module name="px4_flash">
   <doc>
-    <description>Enables to flashes the px4 FBW and AP through the original px4 bootloader.</description>
+    <description>
+      Flash pixhawk via PX4 bootloader.
+      Flashes the PX4IO (STM32F1) through the PX4 bootloader, or resets the PX4FMU (STM32F4) to be flashed directly by the F4' PX4 bootloader.
+    </description>
+    <configure name="PX4IO_UART" value="uart6" description="Uart on PX4FMU connected to PX4IO"/>
+    <configure name="PX4IO_BAUD" value="B1500000" description="Baud rate for PX4IO flashing"/>
+    <configure name="FLASH_PORT" value="usb_serial" description="Port used to connect to the PX4FMU for flashing."/>
+    <configure name="FLASH_BAUD" value="B115200" description="Baud rate for FLASH_PORT if a UART"/>
   </doc>
   <header>
     <file name="px4_flash.h"/>
@@ -10,9 +17,6 @@
   <init fun="px4flash_init()"/>
   <event fun="px4flash_event()"/>
   <makefile target="ap">
-    <raw>
-
-    </raw>
     <file name="px4_flash.c"/>
     <file name="usb_ser_hw.c"  dir="arch/stm32"/>
     <configure name="PX4IO_UART" default="uart6" case="upper|lower"/>
@@ -21,12 +25,11 @@
     <define name="PX4IO_UART" value="$(PX4IO_UART_LOWER)"/>
     <define name="$(PX4IO_UART_UPPER)_BAUD" value="$(PX4IO_BAUD)"/>
 
-    <configure name="FLASH_UART" default="usb_serial" case="upper|lower"/>
+    <configure name="FLASH_PORT" default="usb_serial" case="upper|lower"/>
     <configure name="FLASH_BAUD" default="B115200"/>
-    <define name="USE_$(FLASH_UART_UPPER)"/>
-    <define name="FLASH_UART" value="$(FLASH_UART_LOWER)"/>
-    <define name="$(FLASH_UART_UPPER)_BAUD" value="$(FLASH_BAUD)"/>
-
+    <define name="USE_$(FLASH_PORT_UPPER)"/>
+    <define name="FLASH_UART" value="$(FLASH_PORT_LOWER)"/>
+    <define name="$(FLASH_PORT_UPPER)_BAUD" value="$(FLASH_BAUD)"/>
   </makefile>
 </module>