update pyi

Author: dustin007442

thonnycontrib/quecpython/backend/bare_metal_backend.py

@@ -1115,11 +1115,11 @@ def _cmd_get_fs_info(self, cmd):
 
     def _cmd_upload(self, cmd):
         self._check_sync_time()
-        return super(BareMetalMicroPythonBackend, self)._cmd_upload(cmd)
+        return super(BareMetalQuecPythonBackend, self)._cmd_upload(cmd)
 
     def _cmd_write_file(self, cmd):
         self._check_sync_time()
-        return super(BareMetalMicroPythonBackend, self)._cmd_write_file(cmd)
+        return super(BareMetalQuecPythonBackend, self)._cmd_write_file(cmd)
 
     def _cmd_prepare_disconnect(self, cmd):
         logger.info("Preparing disconnect")
@@ -1709,7 +1709,7 @@ def _report_internal_exception(self, msg: str) -> None:
         )
 
 
-class GenericBareMetalMicroPythonBackend(BareMetalQuecPythonBackend):
+class GenericBareMetalQuecPythonBackend(BareMetalQuecPythonBackend):
     def _get_sys_path_for_analysis(self) -> Optional[List[str]]:
         return [
             os.path.join(os.path.dirname(__file__), "generic_api_stubs"),
@@ -1758,4 +1758,4 @@ def launch_bare_metal_backend(backend_class: Callable[..., BareMetalQuecPythonBa
 
 
 if __name__ == "__main__":
-    launch_bare_metal_backend(GenericBareMetalMicroPythonBackend)
+    launch_bare_metal_backend(GenericBareMetalQuecPythonBackend)

thonnycontrib/quecpython/backend/base_api_stubs/__init__.pyi

@@ -0,0 +1,23 @@
+import win32api
+import win32con
+from pathlib import Path
+
+
+def load():
+    # 获取QuecPython的环境变量
+    QUECPYTHON_PATH = str(Path(__file__).parent)
+    # 打开环境变量键
+    key = win32api.RegOpenKeyEx(
+        win32con.HKEY_LOCAL_MACHINE,
+        'SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment',
+        0,
+        win32con.KEY_ALL_ACCESS
+    )
+    # 更新环境变量值
+    win32api.RegSetValueEx(key, 'PYTHONPATH', 0, 2, QUECPYTHON_PATH)
+    # 关闭键
+    win32api.RegCloseKey(key)
+
+
+if __name__ == '__main__':
+    load()

thonnycontrib/quecpython/backend/base_api_stubs/__main__.py

@@ -1,22 +1,110 @@
 """
-multithreading support.
+Function:
+_thread module contains features related to thread operations, and provides methods for creating and deleting threads, and interfaces related to mutex and semaphore.
 
 Descriptions taken from:
-https://raw.githubusercontent.com/micropython/micropython/master/docs/library/_thread.rst.
-========================================
+https://python.quectel.com/doc/API_reference/en/stdlib/_thread.html
+"""
 
-.. module:: _thread
-   :synopsis: multithreading support
 
-|see_cpython_module| :mod:`python:_thread`.
+def get_ident():
+    """Requires the current thread number.
 
-This module implements multithreading support.
+    @return: Returns the current thread number.
+    """
 
-This module is highly experimental and its API is not yet fully settled
-and not yet described in this documentation.
-"""
+def stack_size(size):
+    """ set thread stack size
+    Setting or getting the stack size which is used to create a thread (Unit: byte) depends on whether size is provided. The stack size is 8448 bytes by default, with a minimum of 8192 bytes.
+
+    @param size: Sets the stack size which is used to create a thread when size is provided.
+    @return: Returns the stack size which is used to create a thread when size is not provided.
+    """
+
+def start_new_thread(function, args):
+    """create new thread.
+    Creates a thread to receive the executing function and the parameter of the executed function, and passes an empty tuple if function has no parameters.
+
+    @param function: The executing function of the thread.
+    @param args: The parameter of the executing function of the thread, which passes an empty tuple when the function has no parameters.
+    @return: Returns the ID of the created thread.
+    """
+
+def threadIsRunning(thread_id):
+    """check if thread is running or not according to `thread_id`.
+
+    :param thread_id: thread ident, a int type.
+    :return: True or False
+    """
+
+def stop_thread(thread_id):
+    """Deletes a thread. The main thread cannot be deleted.
+
+    @param thread_id: The returned ID when the thread is created. If the value is 0, the current thread is deleted.
+    @return: None
+    """
+
+def get_heap_size():
+    """Gets the remaining size of heap in the system.
+
+    @return: Returns the remaining size of heap in the system. (Unit: byte)
+    """
+
+class Lock(object):
+
+    def acquire(self):
+        """Acquires the lock.
+
+        @return: True-Successful execution; False-Failed execution.
+        """
+
+    def release(self):
+        """Releases the lock."""
+
+    def locked(self):
+        """Returns the status of the lock.
+
+        @return: True indicates the status of the lock has been required by some thread; False indicates the status of the lock has not been required by the thread.
+        """
+
+def allocate_lock() -> Lock:
+    """Creates a mutex object.
+
+    @return: Returns the created mutex object.
+    """
+
+def delete_lock(lock):
+    """Deletes the created mutex.
+
+    @param lock: The returned mutex object when the mutex is created.
+    @return: None
+    """
+
+class Semphore(object):
+
+
+    def acquire(self):
+        """Acquires the semphore."""
+
+    def release(self):
+        """Releases the semphore."""
+
+    def getCnt(self):
+        """Gets the maximum value of the semaphore count and the current remaining count value.
+
+        @return: (maxCnt, curCnt)-tuple: maxCnt is the maximum count value, and curCnt is the current remaining count value.
+        """
+
+def allocate_semphore(initcount) -> Semphore:
+    """Creates a semphore object.
+
+    @param initcount: The initial count value and also the maximum value of the semaphore.
+    @return: Returns the created semphore object.
+    """
+
+def delete_semphore(semphore):
+    """Deletes the created semphore.
 
-__author__ = "Howard C Lovatt"
-__copyright__ = "Howard C Lovatt, 2020 onwards."
-__license__ = "MIT https://opensource.org/licenses/MIT (as used by MicroPython)."
-__version__ = "7.3.9"  # Version set by https://github.com/hlovatt/tag2ver
+    @param semphore: The returned semphore object when the semphore is created.
+    @return: None
+    """

thonnycontrib/quecpython/backend/base_api_stubs/_thread.pyi

@@ -0,0 +1,36 @@
+"""
+Function:
+The app_fota module is used for user file upgrades.
+
+Descriptions taken from:
+https://python.quectel.com/doc/API_reference/en/syslib/app_fota.html
+"""
+
+
+class new(object):
+
+    def __init__(self):
+        """Creates an app_fota object."""
+
+    def download(self, url, file_name):
+        """Downloads a single file.
+
+        :param url: String type. The URL of the file to be downloaded.
+        :param file_name: String type. The absolute path of the local file to be upgraded.
+        :return: 0-Successful execution; -1-Failed execution.
+        """
+
+    def bulk_download(self, info):
+        """Downloads bulk files.
+
+        :param info: List type. The bulk download lists. Each element of the list is a dictionary containing url and file_name.
+        :return: Returns the list of failed downloads in list type when the download fails.Returns NULL when the download succeeds.
+        """
+
+    def set_update_flag(self):
+        """Sets the upgrade flag.
+
+        fter the upgrade flag is set, call the restart interface to restart the module.
+        After that, the upgrade process can be started.
+        You can enter the application once the upgrade completes.
+        """

thonnycontrib/quecpython/backend/base_api_stubs/app_fota.pyi

@@ -0,0 +1,21 @@
+"""
+Function:
+This module provides a method for sending AT commands, allowing the QuecPython module to send AT commands through Python code.
+
+Descriptions taken from:
+https://python.quectel.com/doc/API_reference/en/syslib/atcmd.html
+"""
+
+
+def sendSync(atcmd, resp, include_str, timeout):
+    """Sends an AT command to the module.
+
+    :param atcmd: String type. The AT command to be sent, and '\r\n' should be included.
+    :param resp: String type. The string content returned by the AT command.
+    :param include_str: String type. Keyword. The specific values are shown in the table below
+    Value	Description
+    Empty string	Gets all data returned by the AT command (excluding result data such as 'OK') and puts the data into the resp parameter.
+    None-empty string	Filter data containing the keyword and puts the data into the resp parameter.
+    :param timeout: Integer type. Timeout. Unit: second.
+    :return: Returns an integer value. 0 indicates successful execution and other values indicate failed execution.
+    """