Getting ready for 1.4.0

.github/workflows/build-ci.yml

@@ -11,21 +11,13 @@ jobs:
       matrix:
         #os: [windows-2019, macos-10.15, ubuntu-18.04, ubuntu-20.04]
         os: [windows-2019, ubuntu-18.04, ubuntu-20.04]
-        python-version: [3.7, 3.8, 3.9]
+        python-version: [3.8, 3.9]
         exclude:
-          - os: ubuntu-20.04
-            python-version: 3.7       
           - os: ubuntu-18.04
-            python-version: 3.7
-          - os: ubuntu-18.04
-            python-version: 3.9            
-          - os: windows-2019
-            python-version: 3.7             
-          # - os: macos-10.15
-          #   python-version: 3.8
+            python-version: 3.9                   
         include:
-          - os: ubuntu-20.04
-            python-version: 3.8
+          - os: ubuntu-18.04
+            python-version: 3.9
             container: Docker
 
     steps:
@@ -93,12 +85,8 @@ jobs:
         cd ../../../../
         pip3 install -e .[evm]
 
-        if [ ${{ matrix.python-version }} == '3.9' ]; then
-          rm -rf tests/test_evm.py
-        fi
-
-        if [ ${{ matrix.os }} == 'ubuntu-20.04' ]; then
-          docker run -it --rm -v ${GITHUB_WORKSPACE}:/qiling qilingframework/qiling:dev bash -c "rm -rf tests/test_evm.py && cd tests && ./test_onlinux.sh"
+        if [ ${{ matrix.os }} == 'ubuntu-18.04' ] and [ ${{ matrix.python-version }} == '3.9' ]; then
+          docker run -it --rm -v ${GITHUB_WORKSPACE}:/qiling qilingframework/qiling:dev bash -c "cd tests && ./test_onlinux.sh"
         else
           pip3 install setuptools wheel
           cd tests && ./test_onlinux.sh

CREDITS.TXT

@@ -11,20 +11,22 @@ Advisor
 NGUYEN Anh Quynh <aquynh@gmail.com>
 
 
-Travis, Website and Documentations
-==================================
-FOO Kevin (chfl4gs) <chfl4gs@qiling.io>
-
-
-Core Developers
-===============
+Core Developers Crew
+====================
+Earl MARCUS (klks84) klks84@gmail.com
 DING tianze (D1iv3) <dddliv3@gmail.com>
 SUN bowen (w1tcher) <w1tcher.bupt@gmail.com>
 CHEN huitao (null) <null@qiling.io>
 YU tong (sp1ke) <spikeinhouse@gmail.com>
-Earl MARCUS (klks84) klks84@gmail.com
 WU chenxu (kabeor) <kabeor@qiling.io>
 KONG ziqiao (lazymio) <mio@lazym.io>
+YU zheng (dataisland) <dataisland@outlook.com>
+Eli Cohen Nehemia (elicn) <elichn@gmail.com>
+
+
+Travis, Website and Documentations
+==================================
+FOO Kevin (chfl4gs) <chfl4gs@qiling.io>
 
 
 Key Contributors (in no particular order)
@@ -36,7 +38,6 @@ ucgJhe
 jhumble
 Mark Jansen (learn-more)
 cq674350529
-elicn
 bkerler (viperbjk)
 
 

ChangeLog

@@ -1,7 +1,16 @@
 This file details the changelog of Qiling Framework.
 
 ------------------------------------
-[Version 1.3]: Sept 25th, 2021
+[Version 1.4.0]: Oct 20th, 2021
+- Added MCU Engine
+- Bug fix for qdb
+- Bug fix for debugger
+- Bug fix for ql.mem
+- Bump to Unicorn 2
+
+
+------------------------------------
+[Version 1.3.0]: Sept 25th, 2021
 
 - Added QNX
 - Aded Dynamically executed QNX

README.md

@@ -218,35 +218,9 @@ Contact us at email info@qiling.io, or via Twitter [@qiling_io](https://twitter.
 
 ---
 
-#### Core developers
-
-- LAU kaijern (xwings) <kj@qiling.io>
-- NGUYEN Anh Quynh <aquynh@gmail.com>
-- DING tianZe (D1iv3) <dddliv3@gmail.com>
-- SUN bowen (w1tcher) <w1tcher.bupt@gmail.com>
-- CHEN huitao (null) <null@qiling.io>
-- YU tong (sp1ke) <spikeinhouse@gmail.com>
-- Earl Marcus (klks84) klks84@gmail.com 
-- WU chenxu (kabeor) <kabeor@qiling.io>
-- KONG ziqiao (lazymio) <mio@lazym.io>
-
-#### Travis-CI, Docker, Website and Documentation
-
-- FOO Kevin (chfl4gs) <chfl4gs@qiling.io>
-
-#### Key Contributors (in no particular order)
-
-- 0ssigeno
-- liba2k
-- assafcarlsbad
-- ucgJhe
-- jhumble
-- Mark Jansen (learn-more)
-- cq674350529
-- elicn
-- bkerler (viperbjk)
-- madprogrammer
-- danielmoos
+#### Core developers, Key Contributors and etc
+
+Please refer to [CREDITS.TXT](https://github.com/qilingframework/qiling/blob/master/CREDITS.TXT)
 
 ---
 

TODO

@@ -22,4 +22,4 @@ Release
 14. Update version and add in dev 
     __version__ = "X.X.X" + "-dev"
 15. Update changelog and add section for next Update
-16. commit and push
+16. commit and push

examples/mcu/LCD1602A.txt

@@ -0,0 +1,145 @@
+-------------------------------------------------------------------------------------------------
+|     |     |     | ### | ### |#### | #   |     |     |     |     |     |     |     |     |     |
+|     |     |     |#   #|#   #|#   #|  #  |     |     |     |     |     | ####| ### | #  #|# ## |
+|     |     |     |#  ##|    #|#   #|   # |#### |     |     |     |     | #  #|     |# # #|##  #|
+|     |     |     |# # #| ## #|#### |     |#   #|     |     |     |#####|# # #| ### |#  # |#   #|
+|     |     |     |##  #|# # #|#    |     |#### |     |     |     |     |   ##|     | ## #|#### |
+|     |     |     |#   #|# # #|#    |     |#    |     |     |     |     |   # | ### |     |#    |
+|     |     |     | ### | ### |#    |     |#    |     |     |     |     | ##  |    #|     |#    |
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
+-------------------------------------------------------------------------------------------------
+|     |     |  #  |  #  | ### | ### |     |     |     |     |     |#####|   # |     | # # |     |
+|     |     |  #  | ##  |#   #|#   #|     |     |     |     |     |    #|###  |  #  | ### | ## #|
+|     |     |  #  |  #  |#   #|#   #| ### | ## #|     |     |     |  # #|  #  | #   |    #|#  ##|
+|     |     |  #  |  #  |#   #|#   #|    #|#  ##|     |     |     |  ## |#####|#    | ####|#   #|
+|     |     |     |  #  |#####|# # #| ####| ####|     |     |###  |  #  |  #  |#   #|#   #| ####|
+|     |     |     |  #  |#   #|#  # |#   #|    #|     |     |# #  |  #  |  #  |#####| ####|    #|
+|     |     |  #  | ### |#   #| ## #| ####|    #|     |     |###  | #   | #   |    #|     |    #|
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
+-------------------------------------------------------------------------------------------------
+|     |     | # # | ### |#### |#### |#    |     |     |     |  ###|    #|     |     | ### | ### |
+|     |     | # # |#   #|#   #|#   #|#    |     |     |     |  #  |   # |# # #|    #|#   #|#   #|
+|     |     | # # |    #|#   #|#   #|#### |# ## |     |     |  #  |  #  |# # #|    #|#### |#####|
+|     |     |     |   # |#### |#### |#   #|##  #|     |     |  #  | ##  |# # #| # # |#   #|#   #|
+|     |     |     |  #  |#   #|# #  |#   #|#    |     |     |     |# #  |    #|  #  |#### |#   #|
+|     |     |     | #   |#   #|#  # |#   #|#    |     |     |     |  #  |   # | # # |#    | ### |
+|     |     |     |#####|#### |#   #|#### |#    |     |     |     |  #  |  #  |#    |#    |     |
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     |#    |     |
+-------------------------------------------------------------------------------------------------
+|     |     | # # |#####| ### | ####|     |     |     |     |     |  #  | ### |     |     |     |
+|     |     | # # |   # |#   #|#    |     |     |     |     |     |#####|     |#####| ### |     |
+|     |     |#####|  #  |#    |#    | ### | ### |     |     |     |#   #|#####| #   |#    | # ##|
+|     |     | # # |   # |#    | ### |#    |#    |     |     |  #  |#   #|  #  |#####| ##  |# # #|
+|     |     |#####|    #|#    |    #|#    | ### |     |     |  #  |    #|  #  | #   |#   #|## # |
+|     |     | # # |#   #|#   #|    #|#   #|    #|     |     |  #  |   # |  #  | #   | ### |     |
+|     |     | # # | ### | ### |#### | ### |#### |     |     |###  |  #  | #   |  ###|     |     |
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
+-------------------------------------------------------------------------------------------------
+|     |     |  #  |   # |###  |#####|    #| #   |     |     |     |     | #   | #   |     |     |
+|     |     | ####|  ## |#  # |  #  |    #| #   |     |     |     |#####| #   | #   |#   #| ### |
+|     |     |# #  | # # |#   #|  #  | ## #|###  |     |     |     |  #  | #   |#####|#   #|#   #|
+|     |     | ### |#  # |#   #|  #  |#  ##| #   |     |     |     |  #  | ##  | #  #|#   #|#   #|
+|     |     |  # #|#####|#   #|  #  |#   #| #   |     |     |#    |  #  | # # | # # |### #| # # |
+|     |     |#### |   # |#  # |  #  |#   #| #  #|     |     | #   |  #  | #   | #   |#    |## ##|
+|     |     |  #  |   # |###  |  #  | ####|  ## |     |     |  #  |#####| #   | #   |#    |     |
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
+-------------------------------------------------------------------------------------------------
+|     |     |##   |#####|#####|#   #|     |     |     |     |     |   # |  #  |     |     | # # |
+|     |     |##  #|#    |#    |#   #|     |     |     |     |     |#####|  #  | ### | ####|#   #|
+|     |     |   # |#### |#    |#   #| ### |#   #|     |     |     |   # |#####|   # |# #  |#   #|
+|     |     |  #  |    #|#### |#   #|#   #|#   #|     |     | ##  |  ## |  #  |   # |#  # |#  ##|
+|     |     | #   |    #|#    |#   #|#####|#   #|     |     | ##  | # # |  #  |   # | ### | ## #|
+|     |     |#  ##|#   #|#    |#   #|#    |#  ##|     |     |     |#  # | #   |   # |     |     |
+|     |     |   ##| ### |#####| ### | ### | ## #|     |     |     |   # |#    |#####|     |     |
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
+-------------------------------------------------------------------------------------------------
+|     |     | ##  |  ## |#####|#   #|  ## |     |     |     |     | #   |     |     |     |#####|
+|     |     |#  # | #   |#    |#   #| #  #|     |     |     |#####|#####| ### |#####|  ## | #   |
+|     |     |# #  |#    |#    |#   #| #   |#   #|     |     |    #| #  #|     |    #| #  #|  #  |
+|     |     | #   |#### |#### |#   #|###  |#   #|     |     |#####| #  #|     |#####|#   #| #   |
+|     |     |# #  |#   #|#    |#   #| #   |#   #|     |     |    #| #  #|     |    #|#### |#####|
+|     |     |#  # |#   #|#    | # # | #   | # # |     |     |   # | #  #|     |    #|#    |     |
+|     |     | ## #| ### |#    |  #  | #   |  #  |     |     |  #  |#  # |#####|#####|#    |     |
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
+-------------------------------------------------------------------------------------------------
+|     |     | ##  |#####| ### |#   #|     |     |     |     |     |  #  |     | ### |     |     |
+|     |     |  #  |    #|#   #|#   #| ####|     |     |     |     |#####|#####|     | ### |#####|
+|     |     | #   |   # |#    |#   #|#   #|#   #|     |     |#####|  #  |    #|#####|#   #| # # |
+|     |     |     |  #  |# ###|#   #|#   #|#   #|     |     |    #|#####| # # |    #|#   #| # # |
+|     |     |     | #   |#   #|# # #| ####|#   #|     |     |   # |  #  |  #  |    #| ####|#  ##|
+|     |     |     | #   |#   #|# # #|    #|# # #|     |     |  #  |  #  | # # |   # |    #|     |
+|     |     |     | #   | ### | ### | ### | # # |     |     | #   |  #  |#    |  #  |    #|     |
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     | ### |     |
+-------------------------------------------------------------------------------------------------
+|     |     |   # | ### |#   #|#   #|#    |     |     |     |     |     |  #  |#  # |     |#####|
+|     |     |  #  |#   #|#   #|#   #|#    |     |     |     |     | ####|#####|#  # |  ###|#   #|
+|     |     | #   |#   #|#   #| # # |# ## |#   #|     |     |   # | #  #|   # |#  # |  #  | # # |
+|     |     | #   | ### |#####|  #  |##  #| # # |     |     |  #  |#   #|  #  |#  # |  #  |  #  |
+|     |     | #   |#   #|#   #| # # |#   #|  #  |     |     | ##  |    #| ### |   # | #   |#   #|
+|     |     |  #  |#   #|#   #|#   #|#   #| # # |     |     |# #  |   # |# # #|  #  |     |     |
+|     |     |   # | ### |#   #|#   #|#   #|#   #|     |     |  #  | ##  |  #  | #   |     |     |
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
+-------------------------------------------------------------------------------------------------
+|     |     | #   | ### | ### |#   #|  #  |     |     |     |     | #   |   # |     |     |     |
+|     |     |  #  |#   #|  #  |#   #|     |     |     |     |     | ####|   # |  #  |## # |#   #|
+|     |     |   # |#   #|  #  |#   #| ##  |#   #|     |     |  #  |#  # |   # |# #  |   # |#   #|
+|     |     |   # | ####|  #  | # # |  #  |#   #|     |     |#####|   # |   # |# #  |     |#   #|
+|     |     |   # |    #|  #  |  #  |  #  | ####|     |     |#   #|   # |   # |# # #|     | ####|
+|     |     |  #  |   # |  #  |  #  |  #  |    #|     |     |    #|   # |  #  |# # #|     |    #|
+|     |     | #   | ##  | ### |  #  | ### | ### |     |     |  ## |  #  | #   |# ## |     | ### |
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
+-------------------------------------------------------------------------------------------------
+|     |     |     |     |  ###|#####|   # |     |     |     |     |     |     |     |   # |    #|
+|     |     |  #  | ##  |   # |    #|     |     |     |     |     |#####|  #  |#    |     |#### |
+|     |     |# # #| ##  |   # |   # |  ## |#####|     |     |     |    #|   # |#    |  ## |  #  |
+|     |     | ### |     |   # |  #  |   # |   # |     |     |#####|    #|#   #|#   #|   # |#####|
+|     |     |# # #| ##  |   # | #   |   # |  #  |     |     |  #  |    #|#   #|#  # |   # |  #  |
+|     |     |  #  | ##  |#  # |#    |#  # | #   |     |     |  #  |    #|#   #|# #  |   # |     |
+|     |     |     |     | ##  |#####| ##  |#####|     |     |#####|#####|#   #|##   |#  # |     |
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     | ##  |     |
+-------------------------------------------------------------------------------------------------
+|     |     |     |     |#   #| ### |#    |   # |     |     |     | # # |#    |     |# #  |     |
+|     |     |  #  | ##  |#  # | #   |#    |  #  |     |     |     |#####|#    |#####| #   |#####|
+|     |     |  #  | ##  |# #  | #   |#  # |  #  |     |     |   # | # # |#####|#   #|# #  | #   |
+|     |     |#####|     |##   | #   |# #  | #   |     |     |#####| # # |#    |#   #|     | ####|
+|     |     |  #  | ##  |# #  | #   |##   |  #  |     |     |  ## |   # |#    |#   #|     | #  #|
+|     |     |  #  |  #  |#  # | #   |# #  |  #  |     |     | # # |  #  |#    |#   #|     |#   #|
+|     |     |     | #   |#   #| ### |#  # |   # |     |     |#  # | #   | ####|#####|     |     |
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
+-------------------------------------------------------------------------------------------------
+|     |     |     |   # |#    |#   #| ##  |  #  |     |     |     |     |     |     |  #  |     |
+|     |     |     |  #  |#    | # # |  #  |  #  |     |     |     |##   |#####|#####| ### |#####|
+|     |     |     | #   |#    |#####|  #  |  #  |     |     | #   |    #|    #|#   #|# #  |# # #|
+|     |     |     |#    |#    |  #  |  #  |  #  |     |     |#####|##  #|    #|#   #|# # #|#####|
+|     |     | ##  | #   |#    |#####|  #  |  #  |     |     | #  #|    #|    #|    #| ### |#   #|
+|     |     |  #  |  #  |#    |  #  |  #  |  #  |     |     | # # |   # |   # |   # |  #  |#   #|
+|     |     | #   |   # |#####|  #  | ### |  #  |     |     | #   |###  | ##  |  #  |     |     |
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
+-------------------------------------------------------------------------------------------------
+|     |     |     |     |#   #| ### |     | #   |     |     |     |     |     |     | #   |     |
+|     |     |     |     |## ##|   # |     |  #  |     |     |     |#####| #   |##   |###  |  #  |
+|     |     |     |#####|# # #|   # |## # |  #  |     |     |     |    #|# #  |     | #   |#####|
+|     |     |#####|     |# # #|   # |# # #|   # |     |     | ### |   # |   # |    #|###  |  #  |
+|     |     |     |#####|#   #|   # |# # #|  #  |     |     |   # |  #  |    #|    #| #   |     |
+|     |     |     |     |#   #|   # |#   #|  #  |     |     |   # | # # |    #|   # | ####|     |
+|     |     |     |     |#   #| ### |#   #| #   |     |     |#####|#   #|     |###  |     |     |
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
+-------------------------------------------------------------------------------------------------
+|     |     |     | #   |#   #|  #  |     |     |     |     |     | #   |  #  |  #  | ### |     |
+|     |     |     |  #  |#   #| # # |     |  #  |     |     |     |#####|#####|#  # |# ## |     |
+|     |     |     |   # |##  #|#   #|# ## |   # |     |     |#### | #  #|  #  | #   |##  #|     |
+|     |     |     |    #|# # #|     |##  #|#####|     |     |   # | # # |  #  |     |#   #|     |
+|     |     |     |   # |#  ##|     |#   #|   # |     |     |#### | #   |# # #|     |#   #|     |
+|     |     | ##  |  #  |#   #|     |#   #|  #  |     |     |   # | #   |# # #|     |     |     |
+|     |     | ##  | #   |#   #|     |#   #|     |     |     |#### |  ###|  #  |     |     |     |
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |
+-------------------------------------------------------------------------------------------------
+|     |     |     | ### | ### |     |     |     |     |     |     |     |     |###  | # # |#####|
+|     |     |    #|#   #|#   #|     |     |  #  |     |     |     |#   #|#####|# #  | ### |#####|
+|     |     |   # |    #|#   #|     | ### | #   |     |     |     |#   #|    #|###  |#   #|#####|
+|     |     |  #  |   # |#   #|     |#   #|#####|     |     |# # #| #  #|    #|     |#   #|#####|
+|     |     | #   |  #  |#   #|     |#   #| #   |     |     |# # #|    #| # # |     | ### |#####|
+|     |     |#    |     |#   #|     |#   #|  #  |     |     |    #|   # |  #  |     |     |#####|
+|     |     |     |  #  | ### |#####| ### |     |     |     |  ## | ##  |   # |     |     |#####|
+|     |     |     |     |     |     |     |     |     |     |     |     |     |     |     |#####|
+-------------------------------------------------------------------------------------------------

examples/mcu/stm32f4_dma.py

@@ -0,0 +1,25 @@
+import sys
+sys.path.append("../..")
+
+from qiling.core import Qiling
+from qiling.const import QL_VERBOSE
+
+
+def stm32f411_dma():
+    ql = Qiling(["../rootfs/mcu/stm32f411/dma-clock.hex"],                    
+        archtype="cortex_m", profile="stm32f411", verbose=QL_VERBOSE.DEBUG)
+
+    ql.hw.create('usart2')
+    ql.hw.create('dma1')
+    ql.hw.create('rcc')
+
+    ql.run(count=200000)
+    buf = ql.hw.usart2.recv()
+
+    ## check timestamp
+    tick = [int(x) for x in buf.split()]
+    for i in range(1, len(tick)):
+        assert(4 <= tick[i] - tick[i - 1] <= 6)
+
+if __name__ == "__main__":
+    stm32f411_dma()

examples/mcu/stm32f4_freertos.py

@@ -0,0 +1,29 @@
+import sys
+sys.path.append("../..")
+
+from qiling.core import Qiling
+from qiling.const import QL_VERBOSE
+
+
+def stm32f411_freertos():
+    ql = Qiling(["../rootfs/mcu/stm32f411/os-demo.hex"],                    
+        archtype="cortex_m", profile="stm32f411", verbose=QL_VERBOSE.DEBUG)
+
+    ql.hw.create('usart2')
+    ql.hw.create('rcc')
+    ql.hw.create('gpioa')
+
+    count = 0
+    def counter():
+        nonlocal count
+        count += 1
+
+    ql.hw.gpioa.hook_set(5, counter)
+
+    ql.run(count=200000)
+
+    print(count >= 5)
+    print(ql.hw.usart2.recv())
+
+if __name__ == "__main__":
+    stm32f411_freertos()