py-ap200-simple-interface 0.1.0__tar.gz

py_ap200_simple_interface-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GGN_2015
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

py_ap200_simple_interface-0.1.0/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.4
+Name: py-ap200-simple-interface
+Version: 0.1.0
+Summary: a simple interface package for aimooe AP-200.
+License: MIT
+License-File: LICENSE
+Author: GGN_2015
+Author-email: neko@jlulug.org
+Requires-Python: >=3.10
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: Operating System :: Microsoft :: Windows :: Windows 11
+Description-Content-Type: text/markdown
+
+# py_ap200_simple_interface
+a simple interface package for aimooe AP-200.
+
+## Installation
+
+> [!WARNING]
+> This package can only be installed under windows10/11 and x86-64 ISA.
+
+```bash
+pip install py_ap200_simple_interface
+```
+
+## Usage
+
+```python
+from py_ap200_simple_interface import AimooeExtDrive, I_ConnectionMethod
+
+# Initialize AimooeExtDrive
+drive = AimooeExtDrive()
+
+# Connect Methods
+# Select from I_USB, I_ETHERNET and I_WIFI
+connect_method = I_ConnectionMethod.I_WIFI
+
+# USB:
+if connect_method == I_ConnectionMethod.I_USB:
+    drive.connect(I_ConnectionMethod.I_USB)
+
+# Ethernets:
+#     An IP address should be given for ethernet connection
+#     before connecting device with ethernet, you need to confirm that
+#     your ethernet adaptor is in the same IP address segment with the device
+#     and shutdown all proxy service on your computer which may affect the connection
+if connect_method == I_ConnectionMethod.I_ETHERNET:
+    drive.connect(I_ConnectionMethod.I_ETHERNET, "192.168.1.10")
+
+# Wifi:
+#     The wifi name of Aimooe Device is `AimPosition-XXXXXX`
+#     The password of that wireless connection is `aimooe8888`
+if connect_method == I_ConnectionMethod.I_WIFI:
+    drive.connect(I_ConnectionMethod.I_WIFI)
+
+# Some basic information
+print(drive.get_connect_method())
+print(drive.get_device_type())
+print(drive.get_ip_address())
+print(drive.get_manufacture_info())
+print(drive.get_physical_address())
+
+# BONE-1 is a sample specific tool
+# path and toolname should not contain special characters
+print(drive.get_specific_tool_info("./py_ap200_simple_interface/AimooeExt/AimToolsSample/", ["BONE-1"]))
+
+# You can reconnect after disconnect
+# After disconnect, you must reconnect before next use
+drive.disconnect()
+```
+
+### Return value of `drive.get_specific_tool_info`
+
+- `_ToolPath`: The selected tool folder.
+- `_DiscretePoints`: The discrete points which do not lie in any tool listed.
+- `_TimeCost`: The length of time between the begin and end of the device call.
+- `<tool_name>`: Gives the specific infomation of a tool.
+  - `MeanError` and `RMSError`: Error for markers.
+  - `Origin`: The translation vector from tool space to camera space.
+    - i.e. The position of gravity point of markers in camera space, if your tool file is generated by aimooe system.
+  - `Tooltip`: If tooltip is defined, it shows the coordination of tooltip, otherwise the same as `Origin`.
+  - `rMatrix`: The rotation matrix from tool coordination to camera coordination.
+  - `qRotation`: Quaternion form in order $(x, y, z, w) = w + xi + yj + zk$ of the rotation matrix .
+  - `MarkerCoordinates`: The marker coordinates (in camera space) in this tool.
+
+```
+{
+	'_ToolPath': './py_ap200_simple_interface/AimooeExt/AimToolsSample/\\', 
+	'BONE-1': {
+		'MeanError': 0.1138331070542336, 
+		'RMSError': 0.0003674850158859, 
+		'Origin': [-137.575927734375, 120.42643737792969, 793.1155395507812], 
+		'Tooltip': [-137.575927734375, 120.42643737792969, 793.1155395507812], 
+		'Rotation': [2.061613082885742, 1.6536511182785034, -0.4304990470409393], 
+		'qRotation': [0.7492992877960205, 0.601024329662323, -0.1564661413431168, 0.2298665046691895], 
+		'rMatrix': [
+			[0.2285761088132858, 0.9726269245147705, 0.0418308153748512], 
+			[0.828761637210846, -0.1718621850013733, -0.5325575470924377], 
+			[-0.5107907056808472, 0.1563977003097534, -0.8453594446182251]
+		], 
+		'MarkerCoordinates': {
+			'0': [-132.94031926182967, 137.4289669332182, 782.6069181107938], 
+			'1': [-164.12739196778332, 120.93405919807722, 791.4971644346351], 
+			'2': [-115.37230320753432, 126.89401508498568, 790.1637162115628], 
+			'3': [-137.8636773243661, 96.44871350623225, 808.1944560570211]
+		}
+	}, 
+	'_DiscretePoints': {
+		'0': [-144.17166590597648, -200.3791638982969, 1135.5793169583249], 
+		'1': [-198.36308760690474, -156.32112285976535, 1102.102245959862], 
+		'2': [-150.24065470212915, -126.80431827909578, 1094.3467438475025]
+	}, 
+	'_TimeCost': 0.006980419158935547
+}
+```
+

py_ap200_simple_interface-0.1.0/README.md

@@ -0,0 +1,102 @@
+# py_ap200_simple_interface
+a simple interface package for aimooe AP-200.
+
+## Installation
+
+> [!WARNING]
+> This package can only be installed under windows10/11 and x86-64 ISA.
+
+```bash
+pip install py_ap200_simple_interface
+```
+
+## Usage
+
+```python
+from py_ap200_simple_interface import AimooeExtDrive, I_ConnectionMethod
+
+# Initialize AimooeExtDrive
+drive = AimooeExtDrive()
+
+# Connect Methods
+# Select from I_USB, I_ETHERNET and I_WIFI
+connect_method = I_ConnectionMethod.I_WIFI
+
+# USB:
+if connect_method == I_ConnectionMethod.I_USB:
+    drive.connect(I_ConnectionMethod.I_USB)
+
+# Ethernets:
+#     An IP address should be given for ethernet connection
+#     before connecting device with ethernet, you need to confirm that
+#     your ethernet adaptor is in the same IP address segment with the device
+#     and shutdown all proxy service on your computer which may affect the connection
+if connect_method == I_ConnectionMethod.I_ETHERNET:
+    drive.connect(I_ConnectionMethod.I_ETHERNET, "192.168.1.10")
+
+# Wifi:
+#     The wifi name of Aimooe Device is `AimPosition-XXXXXX`
+#     The password of that wireless connection is `aimooe8888`
+if connect_method == I_ConnectionMethod.I_WIFI:
+    drive.connect(I_ConnectionMethod.I_WIFI)
+
+# Some basic information
+print(drive.get_connect_method())
+print(drive.get_device_type())
+print(drive.get_ip_address())
+print(drive.get_manufacture_info())
+print(drive.get_physical_address())
+
+# BONE-1 is a sample specific tool
+# path and toolname should not contain special characters
+print(drive.get_specific_tool_info("./py_ap200_simple_interface/AimooeExt/AimToolsSample/", ["BONE-1"]))
+
+# You can reconnect after disconnect
+# After disconnect, you must reconnect before next use
+drive.disconnect()
+```
+
+### Return value of `drive.get_specific_tool_info`
+
+- `_ToolPath`: The selected tool folder.
+- `_DiscretePoints`: The discrete points which do not lie in any tool listed.
+- `_TimeCost`: The length of time between the begin and end of the device call.
+- `<tool_name>`: Gives the specific infomation of a tool.
+  - `MeanError` and `RMSError`: Error for markers.
+  - `Origin`: The translation vector from tool space to camera space.
+    - i.e. The position of gravity point of markers in camera space, if your tool file is generated by aimooe system.
+  - `Tooltip`: If tooltip is defined, it shows the coordination of tooltip, otherwise the same as `Origin`.
+  - `rMatrix`: The rotation matrix from tool coordination to camera coordination.
+  - `qRotation`: Quaternion form in order $(x, y, z, w) = w + xi + yj + zk$ of the rotation matrix .
+  - `MarkerCoordinates`: The marker coordinates (in camera space) in this tool.
+
+```
+{
+	'_ToolPath': './py_ap200_simple_interface/AimooeExt/AimToolsSample/\\', 
+	'BONE-1': {
+		'MeanError': 0.1138331070542336, 
+		'RMSError': 0.0003674850158859, 
+		'Origin': [-137.575927734375, 120.42643737792969, 793.1155395507812], 
+		'Tooltip': [-137.575927734375, 120.42643737792969, 793.1155395507812], 
+		'Rotation': [2.061613082885742, 1.6536511182785034, -0.4304990470409393], 
+		'qRotation': [0.7492992877960205, 0.601024329662323, -0.1564661413431168, 0.2298665046691895], 
+		'rMatrix': [
+			[0.2285761088132858, 0.9726269245147705, 0.0418308153748512], 
+			[0.828761637210846, -0.1718621850013733, -0.5325575470924377], 
+			[-0.5107907056808472, 0.1563977003097534, -0.8453594446182251]
+		], 
+		'MarkerCoordinates': {
+			'0': [-132.94031926182967, 137.4289669332182, 782.6069181107938], 
+			'1': [-164.12739196778332, 120.93405919807722, 791.4971644346351], 
+			'2': [-115.37230320753432, 126.89401508498568, 790.1637162115628], 
+			'3': [-137.8636773243661, 96.44871350623225, 808.1944560570211]
+		}
+	}, 
+	'_DiscretePoints': {
+		'0': [-144.17166590597648, -200.3791638982969, 1135.5793169583249], 
+		'1': [-198.36308760690474, -156.32112285976535, 1102.102245959862], 
+		'2': [-150.24065470212915, -126.80431827909578, 1094.3467438475025]
+	}, 
+	'_TimeCost': 0.006980419158935547
+}
+```

py_ap200_simple_interface-0.1.0/py_ap200_simple_interface/AimooeExt/AimToolsSample/BONE-1.aimtool

@@ -0,0 +1,10 @@
+BONE-1
+T
+4
+20.606943 -0.005458 0.040331 15
+-4.885081 -26.211561 -0.023027 15
+12.012958 20.049110 -0.035819 15
+-27.734814 6.167912 0.018507 15
+2
+0.000000 0.000000 0.000000
+0.000000 0.000000 0.000000

py_ap200_simple_interface-0.1.0/py_ap200_simple_interface/AimooeExt/AimToolsSample/TEST-1.aimtool

@@ -0,0 +1,10 @@
+TEST-1
+T
+4
+42.725300 -0.023240 -0.021435 15
+-11.625416 35.968346 0.023876 15
+12.000782 -39.477016 0.019787 15
+-43.100666 3.531907 -0.022227 15
+2
+0.000000 0.000000 0.000000
+0.000000 0.000000 0.000000

py_ap200_simple_interface-0.1.0/py_ap200_simple_interface/AimooeExt/AimooeExt_Connect.py

@@ -0,0 +1,40 @@
+import ctypes
+from ctypes import cdll
+from ctypes import c_int, c_ubyte
+
+from enum import Enum
+
+class I_ConnectionMethod(Enum):
+    I_USB = 0
+    I_ETHERNET = 1
+    I_WIFI = 2
+
+def call_AimooeExt_Connect(
+    dll: ctypes.CDLL,
+    EI_code: I_ConnectionMethod,
+    ipa: int = 192,
+    ipb: int = 168,
+    ipc: int = 31,
+    ipd: int = 10
+) -> int:
+    # Define function prototype
+    AimooeExt_Connect = dll.AimooeExt_Connect
+    # 参数类型：int, unsigned char, unsigned char, unsigned char, unsigned char
+    AimooeExt_Connect.argtypes = [c_int, c_ubyte, c_ubyte, c_ubyte, c_ubyte]
+    # 返回值类型：int
+    AimooeExt_Connect.restype = c_int
+
+    # Execute the function
+    result = AimooeExt_Connect(EI_code.value, ipa, ipb, ipc, ipd)
+    return int(result)
+
+if __name__ == "__main__":
+    from AimooeExt.AimooeExt_Init import call_AimooeExt_Init
+    from AimooeExt.AimooeExt_Exit import call_AimooeExt_Exit
+    from AimooeExt.Utils import DLL_PATH
+    print(DLL_PATH)
+    dll = cdll.LoadLibrary(DLL_PATH)
+
+    print(call_AimooeExt_Init(dll))
+    print(call_AimooeExt_Connect(dll, I_ConnectionMethod.I_USB))
+    print(call_AimooeExt_Exit(dll))

py_ap200_simple_interface-0.1.0/py_ap200_simple_interface/AimooeExt/AimooeExt_Exit.py

@@ -0,0 +1,20 @@
+import ctypes
+from ctypes import cdll
+
+def call_AimooeExt_Exit(dll:ctypes.CDLL) -> int:
+    # Define function prototype
+    AimooeExt_Exit = dll.AimooeExt_Exit
+    AimooeExt_Exit.restype = ctypes.c_int  # Return type: int
+
+    # Execute the function
+    result = AimooeExt_Exit()
+    return int(result)
+
+if __name__ == "__main__":
+    from AimooeExt_Init import call_AimooeExt_Init
+    from Utils import DLL_PATH
+    print(DLL_PATH)
+    dll = cdll.LoadLibrary(DLL_PATH)
+
+    print(call_AimooeExt_Init(dll))
+    print(call_AimooeExt_Exit(dll))

py_ap200_simple_interface-0.1.0/py_ap200_simple_interface/AimooeExt/AimooeExt_GetDeviceType.py

@@ -0,0 +1,39 @@
+import ctypes
+from ctypes import cdll
+
+def call_AimooeExt_GetDeviceType(dll:ctypes.CDLL) -> str:
+
+    # Define function prototype
+    AimooeExt_GetDeviceType = dll.AimooeExt_GetDeviceType
+    AimooeExt_GetDeviceType.restype = ctypes.c_int  # Return type: int
+
+    # Execute the function
+    result = int(AimooeExt_GetDeviceType())
+    if result == 0:
+        return "Basic"
+    elif result == 1:
+        return "Standard"
+    elif result == 2:
+        return "AP-400 Industry"
+    elif result == 3:
+        return "Lite"
+    elif result == 4:
+        return "Ultimate"
+    elif result == 100:
+        return "None"
+    else:
+        return "Unknown"
+
+if __name__ == "__main__":
+    from AimooeExt_Init import call_AimooeExt_Init
+    from AimooeExt_Exit import call_AimooeExt_Exit
+    from AimooeExt_Connect import call_AimooeExt_Connect
+    from AimooeExt_Connect import I_ConnectionMethod
+    from Utils import DLL_PATH
+    print(DLL_PATH)
+    dll = cdll.LoadLibrary(DLL_PATH)
+
+    print(call_AimooeExt_Init(dll))
+    print(call_AimooeExt_Connect(dll, I_ConnectionMethod.I_USB))
+    print(call_AimooeExt_GetDeviceType(dll))
+    print(call_AimooeExt_Exit(dll))

py_ap200_simple_interface-0.1.0/py_ap200_simple_interface/AimooeExt/AimooeExt_GetDiscretePoints.py

@@ -0,0 +1,72 @@
+import ctypes
+from ctypes import cdll
+import json
+from typing import Any
+
+try:
+    from .AimooeExt_Connect import I_ConnectionMethod
+except:
+    from AimooeExt_Connect import I_ConnectionMethod
+
+def call_AimooeExt_GetDiscretePoints(
+    dll: ctypes.CDLL,
+    EI: I_ConnectionMethod
+) -> tuple[int, dict[str, Any]]:
+    str_max_len = 65536
+
+    # 函数原型定义
+    AimooeExt_GetDiscretePoints = dll.AimooeExt_GetDiscretePoints
+    AimooeExt_GetDiscretePoints.argtypes = [
+        ctypes.c_int,      # EI
+        ctypes.c_char_p,   # store_str
+        ctypes.c_int       # str_max_len
+    ]
+    AimooeExt_GetDiscretePoints.restype = None  # void 返回
+
+    while True:
+        # 分配缓冲区
+        store_buffer = ctypes.create_string_buffer(str_max_len)
+
+        # 调用函数
+        AimooeExt_GetDiscretePoints(
+            EI.value,
+            store_buffer,
+            str_max_len
+        )
+        result = 1  # void 默认成功
+
+        # 转字符串
+        info_str = store_buffer.value.decode('utf-8', errors='ignore')
+
+        # 判断是否完整（结尾 $）
+        if info_str.rstrip().endswith("$"):
+            break
+
+        # 缓冲区不够，自动翻倍
+        str_max_len <<= 1
+
+    # 去掉结尾的 $
+    if info_str.rstrip().endswith("$"):
+        info_str = info_str.rstrip()[:-1]
+
+    return int(result), json.loads(info_str)
+
+
+if __name__ == "__main__":
+    from AimooeExt_Init import call_AimooeExt_Init
+    from AimooeExt_Exit import call_AimooeExt_Exit
+    from AimooeExt_Connect import call_AimooeExt_Connect
+    from AimooeExt_Connect import I_ConnectionMethod
+    from Utils import DLL_PATH
+
+    print(DLL_PATH)
+    dll = cdll.LoadLibrary(DLL_PATH)
+
+    print(call_AimooeExt_Init(dll))
+    print(call_AimooeExt_Connect(dll, I_ConnectionMethod.I_USB))
+
+    # 调用函数
+    ret, info = call_AimooeExt_GetDiscretePoints(dll, EI=I_ConnectionMethod.I_USB)
+    print(ret, info)
+
+    print(call_AimooeExt_Exit(dll))

py_ap200_simple_interface-0.1.0/py_ap200_simple_interface/AimooeExt/AimooeExt_GetIpAddress.py

@@ -0,0 +1,41 @@
+import ctypes
+from ctypes import cdll
+
+try:
+    from .AimooeExt_Connect import I_ConnectionMethod
+except:
+    from AimooeExt_Connect import I_ConnectionMethod
+
+def call_AimooeExt_GetIpAddress(dll:ctypes.CDLL, EI: I_ConnectionMethod) -> str:
+    # Define function prototype
+    AimooeExt_GetIpAddress = dll.AimooeExt_GetIpAddress
+    AimooeExt_GetIpAddress.argtypes = [ctypes.c_int]  # 参数：枚举类型
+    AimooeExt_GetIpAddress.restype = ctypes.c_uint   # 返回值：unsigned int
+
+    # Execute the function
+    result = AimooeExt_GetIpAddress(EI.value)
+    result = result % (1 << 32)
+
+    # Reconsturct the Ip Address
+    addr_list = []
+    for _ in range(4):
+        addr_list.append(result & 0xFF)
+        result >>= 8
+
+    return ".".join(map(str, addr_list[::-1]))
+
+if __name__ == "__main__":
+    from AimooeExt_Init import call_AimooeExt_Init
+    from AimooeExt_Exit import call_AimooeExt_Exit
+    from AimooeExt_Connect import call_AimooeExt_Connect
+    from AimooeExt_Connect import I_ConnectionMethod
+    from AimooeExt_GetDeviceType import call_AimooeExt_GetDeviceType
+    from Utils import DLL_PATH
+    print(DLL_PATH)
+    dll = cdll.LoadLibrary(DLL_PATH)
+
+    print(call_AimooeExt_Init(dll))
+    print(call_AimooeExt_Connect(dll, I_ConnectionMethod.I_USB))
+    print(call_AimooeExt_GetDeviceType(dll))
+    print(call_AimooeExt_GetIpAddress(dll, EI=I_ConnectionMethod.I_USB))
+    print(call_AimooeExt_Exit(dll))

py_ap200_simple_interface-0.1.0/py_ap200_simple_interface/AimooeExt/AimooeExt_GetManufactureInfo.py

@@ -0,0 +1,68 @@
+import ctypes
+from ctypes import cdll
+
+try:
+    from .AimooeExt_Connect import I_ConnectionMethod
+except:
+    from AimooeExt_Connect import I_ConnectionMethod
+
+def call_AimooeExt_GetManufactureInfo(dll: ctypes.CDLL, EI: I_ConnectionMethod) -> tuple[int, dict[str, str]]:
+    str_max_len = 1024
+    
+    # Define function prototype
+    AimooeExt_GetManufactureInfo = dll.AimooeExt_GetManufactureInfo
+    AimooeExt_GetManufactureInfo.argtypes = [ctypes.c_int, ctypes.c_char_p, ctypes.c_int]
+    AimooeExt_GetManufactureInfo.restype = ctypes.c_int
+
+    while True:
+        # Allocate buffer to receive string (核心：创建字符串缓冲区)
+        store_buffer = ctypes.create_string_buffer(str_max_len)
+
+        # Execute the function
+        result = AimooeExt_GetManufactureInfo(EI.value, store_buffer, str_max_len)
+
+        # Convert buffer to Python string
+        info_str = store_buffer.value.decode('utf-8', errors='ignore')
+        
+        # Error
+        if result != 1:
+            info_str = ""
+            break
+
+        # Check & double buffer
+        if info_str.rstrip().endswith("$"):
+            break
+        str_max_len <<= 1
+
+    # Erase $ at the end
+    if info_str.rstrip().endswith("$"):
+        info_str = info_str.rstrip()[:-1]
+
+    # Get Dict Info
+    info = dict()
+    for line in info_str.split("\n"):
+        if line.find(":") != -1:
+            lpart, rpart = line.split(":", maxsplit=1)
+            lpart = lpart.strip()
+            rpart = rpart.strip()
+            info[lpart] = rpart
+
+    return int(result), info
+
+if __name__ == "__main__":
+    from AimooeExt_Init import call_AimooeExt_Init
+    from AimooeExt_Exit import call_AimooeExt_Exit
+    from AimooeExt_Connect import call_AimooeExt_Connect
+    from AimooeExt_Connect import I_ConnectionMethod
+    from AimooeExt_GetDeviceType import call_AimooeExt_GetDeviceType
+    from Utils import DLL_PATH
+    print(DLL_PATH)
+    dll = cdll.LoadLibrary(DLL_PATH)
+
+    print(call_AimooeExt_Init(dll))
+    print(call_AimooeExt_Connect(dll, I_ConnectionMethod.I_USB))
+    
+    ret, info = call_AimooeExt_GetManufactureInfo(dll, EI=I_ConnectionMethod.I_USB)
+    print(ret, info)
+
+    print(call_AimooeExt_Exit(dll))

py_ap200_simple_interface-0.1.0/py_ap200_simple_interface/AimooeExt/AimooeExt_GetPhysicalAddress.py

@@ -0,0 +1,39 @@
+import ctypes
+from ctypes import cdll
+
+def call_AimooeExt_GetPhysicalAddress(dll: ctypes.CDLL) -> tuple[int, str]:
+    str_max_len = 20
+
+    # Define function prototype
+    AimooeExt_GetPhysicalAddress = dll.AimooeExt_GetPhysicalAddress
+    AimooeExt_GetPhysicalAddress.argtypes = [ctypes.c_char_p, ctypes.c_int]
+    AimooeExt_GetPhysicalAddress.restype = ctypes.c_int
+
+    # Allocate buffer to receive string
+    store_buffer = ctypes.create_string_buffer(str_max_len)
+
+    # Execute the function
+    result = AimooeExt_GetPhysicalAddress(store_buffer, str_max_len)
+
+    # Convert buffer to Python string
+    address_str = store_buffer.value.decode('utf-8', errors='ignore')
+
+    return int(result), address_str
+
+if __name__ == "__main__":
+    from AimooeExt_Init import call_AimooeExt_Init
+    from AimooeExt_Exit import call_AimooeExt_Exit
+    from AimooeExt_Connect import call_AimooeExt_Connect
+    from AimooeExt_Connect import I_ConnectionMethod
+    from AimooeExt_GetDeviceType import call_AimooeExt_GetDeviceType
+    from Utils import DLL_PATH
+    print(DLL_PATH)
+    dll = cdll.LoadLibrary(DLL_PATH)
+
+    print(call_AimooeExt_Init(dll))
+    print(call_AimooeExt_Connect(dll, I_ConnectionMethod.I_USB))
+    
+    ret, address = call_AimooeExt_GetPhysicalAddress(dll)
+    print(ret, address)
+
+    print(call_AimooeExt_Exit(dll))

py_ap200_simple_interface-0.1.0/py_ap200_simple_interface/AimooeExt/AimooeExt_GetSpecificToolInfo.py

@@ -0,0 +1,112 @@
+import ctypes
+from ctypes import cdll
+import os
+import json
+
+try:
+    from .AimooeExt_Connect import I_ConnectionMethod
+except:
+    from AimooeExt_Connect import I_ConnectionMethod
+
+def has_non_ascii(s: str) -> bool:
+    for char in s:
+        if ord(char) > 127 or ord(char) < 0:
+            return True
+    return False
+
+def call_AimooeExt_GetSpecificToolInfo(
+    dll: ctypes.CDLL,
+    EI: I_ConnectionMethod,
+    toolpath: str,
+    toolname_list: list[str],
+    path_encoding="utf-8"
+) -> tuple[int, dict]:
+    str_max_len = 65536
+    
+    if not os.path.isdir(toolpath):
+        raise FileNotFoundError("{toolpath} is not an available path.")
+    
+    if has_non_ascii(toolpath):
+        raise ValueError(f"path {toolpath} has non ascii character.")
+
+    if not toolpath.endswith(os.sep):
+        toolpath += os.sep
+
+    # Define function prototype
+    AimooeExt_GetSpecificToolInfo = dll.AimooeExt_GetSpecificToolInfo
+    AimooeExt_GetSpecificToolInfo.argtypes = [
+        ctypes.c_int,
+        ctypes.c_char_p,
+        ctypes.c_char_p,
+        ctypes.c_char_p,
+        ctypes.c_int
+    ]
+
+    # 返回类型用 None
+    AimooeExt_GetSpecificToolInfo.restype = None
+
+    # Convert Python strings to C-style bytes
+    toolpath_c = toolpath.encode(path_encoding)
+    toolname_list_c = "$".join(toolname_list).encode(path_encoding)
+
+    while True:
+        # Allocate buffer to receive string
+        store_buffer = ctypes.create_string_buffer(str_max_len)
+
+        # Execute the function (void 无返回值)
+        AimooeExt_GetSpecificToolInfo(
+            EI.value,
+            toolpath_c,
+            toolname_list_c,
+            store_buffer,
+            str_max_len
+        )
+        
+        # 按照你库的规则，默认调用成功 result=1
+        result = 1
+
+        # Convert buffer to Python string
+        info_str = store_buffer.value.decode('utf-8', errors='ignore')
+        
+        # Check if string ends with $ (end marker)
+        if info_str.rstrip().endswith("$"):
+            break
+        
+        # Double buffer size if not complete
+        str_max_len <<= 1
+
+    # Erase $ at the end
+    if info_str.rstrip().endswith("$"):
+        info_str = info_str.rstrip()[:-1]
+
+    # Can not find '$', failed.
+    else:
+        return 0, dict()
+
+    # Get Dict
+    dict_data = json.loads(info_str)
+    return int(result), dict_data
+
+if __name__ == "__main__":
+    from AimooeExt_Init import call_AimooeExt_Init
+    from AimooeExt_Exit import call_AimooeExt_Exit
+    from AimooeExt_Connect import call_AimooeExt_Connect
+    from AimooeExt_Connect import I_ConnectionMethod
+    from Utils import DLL_PATH, TOOL_SAMPLE_DIR
+    print(DLL_PATH)
+    dll = cdll.LoadLibrary(DLL_PATH)
+
+    print(call_AimooeExt_Init(dll))
+    print(call_AimooeExt_Connect(dll, I_ConnectionMethod.I_USB))
+    
+    # 调用示例
+    ret, info = call_AimooeExt_GetSpecificToolInfo(
+        dll,
+        EI=I_ConnectionMethod.I_USB,
+        toolpath=os.path.relpath(TOOL_SAMPLE_DIR, os.getcwd()),
+        toolname_list=["BONE-1"]
+    )
+    print(ret)
+    print(info)
+
+    print(call_AimooeExt_Exit(dll))

py_ap200_simple_interface-0.1.0/py_ap200_simple_interface/AimooeExt/AimooeExt_Init.py

@@ -0,0 +1,18 @@
+import ctypes
+from ctypes import cdll
+
+def call_AimooeExt_Init(dll:ctypes.CDLL) -> int:
+
+    # Define function prototype
+    AimooeExt_Init = dll.AimooeExt_Init
+    AimooeExt_Init.restype = ctypes.c_int  # Return type: int
+
+    # Execute the function
+    result = AimooeExt_Init()
+    return int(result)
+
+if __name__ == "__main__":
+    from Utils import DLL_PATH
+    print(DLL_PATH)
+    dll = cdll.LoadLibrary(DLL_PATH)
+    print(call_AimooeExt_Init(dll))

py_ap200_simple_interface-0.1.0/py_ap200_simple_interface/AimooeExt/Utils.py

@@ -0,0 +1,18 @@
+import os
+import sys
+import platform
+
+DIRNOW = os.path.dirname(os.path.abspath(__file__))
+BIN_DIR = os.path.join(DIRNOW, "bin")
+DLL_PATH = os.path.join(BIN_DIR, "AimooeExt_Interface2.3.4.dll")
+TOOL_SAMPLE_DIR = os.path.join(DIRNOW, "AimToolsSample")
+
+if not os.path.isfile(DLL_PATH):
+    raise FileNotFoundError("py_aimooe_simple_interface: dll not found.")
+
+# Check if the system and ISA is windows and x86-64
+def is_windows_x86_64() -> bool:
+    is_windows = sys.platform.startswith("win")
+    arch = platform.machine().lower()
+    is_64bit = arch in ("amd64", "x86_64", "x64")    
+    return is_windows and is_64bit

py_ap200_simple_interface-0.1.0/py_ap200_simple_interface/AimooeExt/__init__.py

@@ -0,0 +1,25 @@
+from .AimooeExt_Connect import call_AimooeExt_Connect, I_ConnectionMethod
+from .AimooeExt_Exit import call_AimooeExt_Exit
+from .AimooeExt_GetDeviceType import call_AimooeExt_GetDeviceType
+from .AimooeExt_GetDiscretePoints import call_AimooeExt_GetDiscretePoints
+from .AimooeExt_GetIpAddress import call_AimooeExt_GetIpAddress
+from .AimooeExt_GetManufactureInfo import call_AimooeExt_GetManufactureInfo
+from .AimooeExt_GetPhysicalAddress import call_AimooeExt_GetPhysicalAddress
+from .AimooeExt_GetSpecificToolInfo import call_AimooeExt_GetSpecificToolInfo
+from .AimooeExt_Init import call_AimooeExt_Init
+from .Utils import DLL_PATH, is_windows_x86_64
+
+__all__ = [
+    "call_AimooeExt_Connect",
+    "call_AimooeExt_Exit",
+    "call_AimooeExt_GetDeviceType",
+    "call_AimooeExt_GetDiscretePoints",
+    "call_AimooeExt_GetIpAddress",
+    "call_AimooeExt_GetManufactureInfo",
+    "call_AimooeExt_GetPhysicalAddress",
+    "call_AimooeExt_GetSpecificToolInfo",
+    "call_AimooeExt_Init",
+    "I_ConnectionMethod",
+    "DLL_PATH",
+    "is_windows_x86_64"
+]

py_ap200_simple_interface-0.1.0/py_ap200_simple_interface/AimooeExtDrive.py

@@ -0,0 +1,144 @@
+from ctypes import cdll
+from typing import Any, Optional
+import atexit
+import time
+
+try:
+    from . import AimooeExt
+    from .AimooeExt import I_ConnectionMethod, is_windows_x86_64
+except:
+    import AimooeExt
+    from AimooeExt import I_ConnectionMethod, is_windows_x86_64
+
+class AimooeExtDrive:
+    _instance = None
+
+    @classmethod
+    def __new__(cls, *args, **kwargs):
+        if cls._instance is None:
+            self = super().__new__(cls)
+            cls._instance = self
+        return cls._instance
+    
+    def __init__(self) -> None:
+        if not is_windows_x86_64():
+            raise OSError("Only amd64 and windows system are supported.")
+
+        # Do not initialize twice
+        if hasattr(self, "_connect_method"):
+            return
+        self._connect_method = None
+        self._dll = cdll.LoadLibrary(AimooeExt.DLL_PATH)
+
+        # Try to initialize
+        ret = AimooeExt.call_AimooeExt_Init(self._dll)
+        if ret != 1:
+            raise RuntimeError("Can not initialize.")
+    
+    def get_connect_method(self) -> Optional[AimooeExt.I_ConnectionMethod]:
+        return self._connect_method
+    
+    # The same with connect
+    def reconnect(self, _connect_method:AimooeExt.I_ConnectionMethod, _ip_addr:Optional[str]=None):
+        self.connect(_connect_method, _ip_addr)
+
+    def connect(self, _connect_method:AimooeExt.I_ConnectionMethod, _ip_addr:Optional[str]=None):
+        if self._connect_method is not None:
+            self.disconnect()
+
+        # Do clean up when exit
+        atexit.register(self._clean_up)
+
+        # _ip_addr must given when I_ETHERNET
+        self._connect_method = _connect_method
+        self._ip_addr = _ip_addr
+        if self._connect_method == I_ConnectionMethod.I_ETHERNET:
+            if self._ip_addr is None:
+                raise ValueError("")
+
+        # unpack _ip_addr
+        ipa, ipb, ipc, ipd = 192, 168, 31, 10
+        if self._ip_addr is not None:
+            ipa, ipb, ipc, ipd = map(int, self._ip_addr.split("."))
+
+        ret = AimooeExt.call_AimooeExt_Connect(
+            self._dll, self._connect_method, ipa, ipb, ipc, ipd)
+
+        if ret != 1:
+            self._connect_method = None
+            raise RuntimeError("Can not connect.")
+
+    # Real Exit, Do not call this manually
+    def _clean_up(self):
+        AimooeExt.call_AimooeExt_Exit(self._dll)
+
+    def disconnect(self):
+        self._connect_method = None
+
+    def get_device_type(self) -> str:
+        if self._connect_method is None:
+            raise RuntimeError("Connect first.")
+        return AimooeExt.call_AimooeExt_GetDeviceType(self._dll)
+    
+    def get_ip_address(self) -> str:
+        if self._connect_method is None:
+            raise RuntimeError("Connect first.")
+        return AimooeExt.call_AimooeExt_GetIpAddress(
+            self._dll, self._connect_method)
+
+    def get_manufacture_info(self) -> dict[str, str]:
+        if self._connect_method is None:
+            raise RuntimeError("Connect first.")
+        
+        ret, info = AimooeExt.call_AimooeExt_GetManufactureInfo(
+            self._dll, self._connect_method)
+        if ret != 1:
+            raise RuntimeError("Can not get info.")
+        return info
+
+    def get_physical_address(self) -> str:
+        if self._connect_method is None:
+            raise RuntimeError("Connect first.")
+        ret, info = AimooeExt.call_AimooeExt_GetPhysicalAddress(self._dll)
+        if ret != 1:
+            raise RuntimeError("Can not get address.")
+        return info
+
+    def get_specific_tool_info(self, 
+        tool_path:str, tool_list:list[str], path_encoding:str="utf-8") -> dict[str, Any]:
+        begin_time = time.time()
+
+        if self._connect_method is None:
+            raise RuntimeError("Connect first.")
+        ret, info = AimooeExt.call_AimooeExt_GetSpecificToolInfo(
+            self._dll, self._connect_method, tool_path, tool_list, path_encoding)
+        
+        if len(tool_list) == 0:
+            ret, info = AimooeExt.call_AimooeExt_GetDiscretePoints(
+                self._dll, self._connect_method)
+
+        if ret != 1:
+            raise RuntimeError("Can not get info.")
+        
+        end_time = time.time()
+        info["_TimeCost"] = end_time - begin_time
+        return info
+
+if __name__ == "__main__":
+    import os
+    DIRNOW = os.path.dirname(os.path.abspath(__file__))
+    drive = AimooeExtDrive()
+    drive.connect(I_ConnectionMethod.I_USB)
+
+    print(drive.get_connect_method())
+    print(drive.get_device_type())
+    print(drive.get_ip_address())
+    print(drive.get_manufacture_info())
+    print(drive.get_physical_address())
+
+    print(drive.get_specific_tool_info(
+        os.path.relpath(
+            os.path.join(DIRNOW, "AimooeExt", "AimToolsSample"),
+            os.getcwd()
+        ), []))
+    drive.disconnect()

py_ap200_simple_interface-0.1.0/py_ap200_simple_interface/__init__.py

@@ -0,0 +1,6 @@
+from .AimooeExtDrive import AimooeExtDrive, I_ConnectionMethod
+
+__all__ = [
+    "AimooeExtDrive",
+    "I_ConnectionMethod"
+]

py_ap200_simple_interface-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "py-ap200-simple-interface"
+version = "0.1.0"
+description = "a simple interface package for aimooe AP-200."
+authors = [
+    {name = "GGN_2015",email = "neko@jlulug.org"}
+]
+license = {text = "MIT"}
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+]
+classifiers = [
+    "Operating System :: Microsoft :: Windows :: Windows 10",
+    "Operating System :: Microsoft :: Windows :: Windows 11"
+]
+platform = "windows-x86_64"
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"