twister: document: update document help for script

No scripts will have a default parameter testinstance.name
also add twister document for scripts

Signed-off-by: Hake Huang <[email protected]>

Author: hakehuang

doc/develop/test/twister.rst

@@ -1315,6 +1315,38 @@ Using Single Board For Multiple Variants
       runner: nrfjprog
       serial: /dev/ttyACM1
 
+Scripts Usage for platform
+++++++++++++++++++++++++++
+
+Below scripts are supported
+
+* pre_script: <path to pre script>
+
+* post_script: <path to pre script>
+
+* post_flash_script: <path to pre script>
+
+each of above scripts can have timeout defined as below in hardwar map file by script_param
+
+.. code-block:: yaml
+
+    - connected: false
+      id: 0229000005d9ebc600000000000000000000000097969905
+      platform: mimxrt1060_evk
+      probe_id: 000609301751
+      product: DAPLink CMSIS-DAP
+      runner: jlink
+      serial: null
+      pre_script: pre_scripts.sh
+      post_script: post_scripts.sh
+      post_flash_script: post_flash_scripts.sh
+      script_param:
+        "pre_script_timeout":  100
+        "post_script_timeout": 100
+        "post_flash_timeout":  100
+
+also a default patameter <testinstance.name> will be pass as fist parameter for scripts
+
 Quarantine
 ++++++++++
 

scripts/pylib/twister/twisterlib/environment.py

@@ -640,7 +640,8 @@ def add_parse_arguments(parser = None) -> argparse.ArgumentParser:
 
     parser.add_argument("--pre-script",
                         help="""specify a pre script. This will be executed
-                        before device handler open serial port and invoke runner.
+                        before device handler open serial port and invoke runner,
+                        and testinstance name will be its first parameter.
                         """)
 
     parser.add_argument(