ifxusb010 0.1.4__tar.gz

ifxusb010-0.1.4/.gitignore

@@ -0,0 +1,2 @@
+.env*/
+__pycache__/

ifxusb010-0.1.4/.python-version

@@ -0,0 +1 @@
+3.12

ifxusb010-0.1.4/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: ifxusb010
+Version: 0.1.4
+Summary: python for Infineon USB010
+Author-email: a9202507 <a9202507@gmail.com>
+Requires-Python: >=3.12
+Requires-Dist: bitarray>=3.8.0
+Requires-Dist: libusb-package>=1.0.26.3
+Requires-Dist: pyusb>=1.3.1
+Requires-Dist: pywinusb>=0.4.2
+Requires-Dist: wmi>=1.5.1
+Provides-Extra: dev
+Requires-Dist: mypy>=1.19.1; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# ifxusb010
+
+Python library for Infineon USB010 I2C dongle.
+
+## Installation
+
+```bash
+pip install ifxusb010
+```
+
+Or install from TestPyPI:
+
+```bash
+pip install -i https://test.pypi.org/simple/ ifxusb010
+```
+
+> **Note:** Windows 使用者需先用 [Zadig](https://zadig.akeo.ie/) 將 USB010 dongle 的驅動程式替換為 WinUSB。
+
+---
+
+## Quick Start
+
+```python
+import ifxusb010
+
+# 連接 USB010 dongle
+dev = ifxusb010.connect_device()
+```
+
+---
+
+## API Reference
+
+### `connect_device(vendor_id=0x058B, product_id=0x0230)`
+
+連接 USB010 dongle，回傳 USB device 物件。
+
+| 參數 | 型別 | 預設值 | 說明 |
+|------|------|--------|------|
+| `vendor_id` | int | `0x058B` | USB Vendor ID |
+| `product_id` | int | `0x0230` | USB Product ID |
+
+**回傳值：** `usb.core.Device` 物件
+
+---
+
+### `search_I2C(dev, start_address, end_address, debug, enable_8bit_mode)`
+
+掃描 I2C bus 上的裝置。
+
+| 參數 | 型別 | 預設值 | 說明 |
+|------|------|--------|------|
+| `dev` | Device | `None` | USB device 物件，`None` 會自動連接 |
+| `start_address` | int | `0x20` | 掃描起始地址 (8-bit) |
+| `end_address` | int | `0xFE` | 掃描結束地址 (8-bit) |
+| `debug` | bool | `False` | 印出 debug 資訊 |
+| `enable_8bit_mode` | bool | `True` | `True` 回傳 8-bit 地址，`False` 回傳 7-bit 地址 |
+
+**回傳值：** `list` — 找到的裝置地址列表
+
+```python
+dev = ifxusb010.connect_device()
+devices = ifxusb010.search_I2C(dev=dev)
+# avaliable device found at 8bits address 0x40
+# devices = [0x40]
+```
+
+---
+
+### `multiReadWriteFunction(dev, device_address, write_command_code_list, read_number_length, debug)`
+
+通用 I2C 讀寫函式，支援**純寫入**和**寫入後讀取**兩種模式。
+
+| 參數 | 型別 | 預設值 | 說明 |
+|------|------|--------|------|
+| `dev` | Device | `None` | USB device 物件，`None` 會自動連接 |
+| `device_address` | int | `0x40` | I2C 裝置寫地址 (8-bit，偶數) |
+| `write_command_code_list` | list | `None` | 要寫入的資料列表 |
+| `read_number_length` | int | `0` | 要讀取的 byte 數，`0` 表示純寫入 |
+| `debug` | bool | `False` | 印出 debug 資訊 |
+
+**回傳值：**
+
+```python
+{
+    "transactionErrorCode": int,  # 0 表示成功
+    "readData": list              # 讀回的資料（純寫入時為空列表 []）
+}
+```
+
+#### 模式說明
+
+| `read_number_length` | 模式 | I2C 地址 | 行為 |
+|---|---|---|---|
+| `0` | 純寫入 | 偶數地址 (e.g. `0x40`) | 只寫入資料，不讀回 |
+| `> 0` | 寫入 + 讀取 | 奇數地址 (e.g. `0x41`) | 寫入後讀取指定數量的 byte |
+
+#### 範例 1：純寫入 (Write Only)
+
+```python
+import ifxusb010
+
+dev = ifxusb010.connect_device()
+
+# 寫入 6 bytes 到 I2C 裝置 0x40
+ifxusb010.multiReadWriteFunction(
+    dev=dev,
+    device_address=0x40,
+    write_command_code_list=[0xFD, 0x04, 0x00, 0x00, 0x00, 0x00],
+    read_number_length=0
+)
+# I2C write to 0x40 success
+```
+
+#### 範例 2：寫入後讀取 (Write + Read)
+
+```python
+import ifxusb010
+
+dev = ifxusb010.connect_device()
+
+# 寫入 1 byte (register address)，然後讀回 5 bytes
+result = ifxusb010.multiReadWriteFunction(
+    dev=dev,
+    device_address=0x40,
+    write_command_code_list=[0xFD],
+    read_number_length=5
+)
+
+print(result["transactionErrorCode"])  # 0 = 成功
+print([hex(x) for x in result["readData"]])
+# ['0x4', '0xf9', '0x57', '0xe9', '0x73']
+```
+
+#### 範例 3：連續多筆 I2C 操作
+
+共用同一個 `dev` 物件，連續執行多筆 I2C 指令：
+
+```python
+import ifxusb010
+
+dev = ifxusb010.connect_device()
+
+# Step 1: 寫入設定暫存器
+ifxusb010.multiReadWriteFunction(
+    dev=dev,
+    device_address=0x40,
+    write_command_code_list=[0xFD, 0x04, 0x00, 0x00, 0x00, 0x00],
+    read_number_length=0
+)
+
+# Step 2: 寫入觸發指令
+ifxusb010.multiReadWriteFunction(
+    dev=dev,
+    device_address=0x40,
+    write_command_code_list=[0xFE, 0x2D],
+    read_number_length=0
+)
+
+# Step 3: 讀回結果 (5 bytes)
+result = ifxusb010.multiReadWriteFunction(
+    dev=dev,
+    device_address=0x40,
+    write_command_code_list=[0xFD],
+    read_number_length=5
+)
+
+if result["transactionErrorCode"] == 0:
+    print(f"讀回的資料: {[hex(x) for x in result['readData']]}")
+else:
+    print(f"交易失敗，錯誤碼: {result['transactionErrorCode']}")
+```
+
+---
+
+### `mrw(dev, device_address, data, debug)`
+
+簡化版的寫入函式，內部呼叫 `multiReadWriteFunction`。
+
+| 參數 | 型別 | 預設值 | 說明 |
+|------|------|--------|------|
+| `dev` | Device | `None` | USB device 物件 |
+| `device_address` | int | `0x40` | I2C 裝置寫地址 (8-bit) |
+| `data` | list | `[0xFD, 0x04, 0x00, 0x00, 0x00, 0x00]` | 要寫入的資料 |
+| `debug` | bool | `False` | 印出 debug 資訊 |
+
+**回傳值：** `int` — `transactionErrorCode`（0 表示成功）
+
+```python
+dev = ifxusb010.connect_device()
+error_code = ifxusb010.mrw(dev=dev, device_address=0x40, data=[0xFD, 0x04, 0x00, 0x00, 0x00, 0x00])
+```

ifxusb010-0.1.4/README.md

@@ -0,0 +1,192 @@
+# ifxusb010
+
+Python library for Infineon USB010 I2C dongle.
+
+## Installation
+
+```bash
+pip install ifxusb010
+```
+
+Or install from TestPyPI:
+
+```bash
+pip install -i https://test.pypi.org/simple/ ifxusb010
+```
+
+> **Note:** Windows 使用者需先用 [Zadig](https://zadig.akeo.ie/) 將 USB010 dongle 的驅動程式替換為 WinUSB。
+
+---
+
+## Quick Start
+
+```python
+import ifxusb010
+
+# 連接 USB010 dongle
+dev = ifxusb010.connect_device()
+```
+
+---
+
+## API Reference
+
+### `connect_device(vendor_id=0x058B, product_id=0x0230)`
+
+連接 USB010 dongle，回傳 USB device 物件。
+
+| 參數 | 型別 | 預設值 | 說明 |
+|------|------|--------|------|
+| `vendor_id` | int | `0x058B` | USB Vendor ID |
+| `product_id` | int | `0x0230` | USB Product ID |
+
+**回傳值：** `usb.core.Device` 物件
+
+---
+
+### `search_I2C(dev, start_address, end_address, debug, enable_8bit_mode)`
+
+掃描 I2C bus 上的裝置。
+
+| 參數 | 型別 | 預設值 | 說明 |
+|------|------|--------|------|
+| `dev` | Device | `None` | USB device 物件，`None` 會自動連接 |
+| `start_address` | int | `0x20` | 掃描起始地址 (8-bit) |
+| `end_address` | int | `0xFE` | 掃描結束地址 (8-bit) |
+| `debug` | bool | `False` | 印出 debug 資訊 |
+| `enable_8bit_mode` | bool | `True` | `True` 回傳 8-bit 地址，`False` 回傳 7-bit 地址 |
+
+**回傳值：** `list` — 找到的裝置地址列表
+
+```python
+dev = ifxusb010.connect_device()
+devices = ifxusb010.search_I2C(dev=dev)
+# avaliable device found at 8bits address 0x40
+# devices = [0x40]
+```
+
+---
+
+### `multiReadWriteFunction(dev, device_address, write_command_code_list, read_number_length, debug)`
+
+通用 I2C 讀寫函式，支援**純寫入**和**寫入後讀取**兩種模式。
+
+| 參數 | 型別 | 預設值 | 說明 |
+|------|------|--------|------|
+| `dev` | Device | `None` | USB device 物件，`None` 會自動連接 |
+| `device_address` | int | `0x40` | I2C 裝置寫地址 (8-bit，偶數) |
+| `write_command_code_list` | list | `None` | 要寫入的資料列表 |
+| `read_number_length` | int | `0` | 要讀取的 byte 數，`0` 表示純寫入 |
+| `debug` | bool | `False` | 印出 debug 資訊 |
+
+**回傳值：**
+
+```python
+{
+    "transactionErrorCode": int,  # 0 表示成功
+    "readData": list              # 讀回的資料（純寫入時為空列表 []）
+}
+```
+
+#### 模式說明
+
+| `read_number_length` | 模式 | I2C 地址 | 行為 |
+|---|---|---|---|
+| `0` | 純寫入 | 偶數地址 (e.g. `0x40`) | 只寫入資料，不讀回 |
+| `> 0` | 寫入 + 讀取 | 奇數地址 (e.g. `0x41`) | 寫入後讀取指定數量的 byte |
+
+#### 範例 1：純寫入 (Write Only)
+
+```python
+import ifxusb010
+
+dev = ifxusb010.connect_device()
+
+# 寫入 6 bytes 到 I2C 裝置 0x40
+ifxusb010.multiReadWriteFunction(
+    dev=dev,
+    device_address=0x40,
+    write_command_code_list=[0xFD, 0x04, 0x00, 0x00, 0x00, 0x00],
+    read_number_length=0
+)
+# I2C write to 0x40 success
+```
+
+#### 範例 2：寫入後讀取 (Write + Read)
+
+```python
+import ifxusb010
+
+dev = ifxusb010.connect_device()
+
+# 寫入 1 byte (register address)，然後讀回 5 bytes
+result = ifxusb010.multiReadWriteFunction(
+    dev=dev,
+    device_address=0x40,
+    write_command_code_list=[0xFD],
+    read_number_length=5
+)
+
+print(result["transactionErrorCode"])  # 0 = 成功
+print([hex(x) for x in result["readData"]])
+# ['0x4', '0xf9', '0x57', '0xe9', '0x73']
+```
+
+#### 範例 3：連續多筆 I2C 操作
+
+共用同一個 `dev` 物件，連續執行多筆 I2C 指令：
+
+```python
+import ifxusb010
+
+dev = ifxusb010.connect_device()
+
+# Step 1: 寫入設定暫存器
+ifxusb010.multiReadWriteFunction(
+    dev=dev,
+    device_address=0x40,
+    write_command_code_list=[0xFD, 0x04, 0x00, 0x00, 0x00, 0x00],
+    read_number_length=0
+)
+
+# Step 2: 寫入觸發指令
+ifxusb010.multiReadWriteFunction(
+    dev=dev,
+    device_address=0x40,
+    write_command_code_list=[0xFE, 0x2D],
+    read_number_length=0
+)
+
+# Step 3: 讀回結果 (5 bytes)
+result = ifxusb010.multiReadWriteFunction(
+    dev=dev,
+    device_address=0x40,
+    write_command_code_list=[0xFD],
+    read_number_length=5
+)
+
+if result["transactionErrorCode"] == 0:
+    print(f"讀回的資料: {[hex(x) for x in result['readData']]}")
+else:
+    print(f"交易失敗，錯誤碼: {result['transactionErrorCode']}")
+```
+
+---
+
+### `mrw(dev, device_address, data, debug)`
+
+簡化版的寫入函式，內部呼叫 `multiReadWriteFunction`。
+
+| 參數 | 型別 | 預設值 | 說明 |
+|------|------|--------|------|
+| `dev` | Device | `None` | USB device 物件 |
+| `device_address` | int | `0x40` | I2C 裝置寫地址 (8-bit) |
+| `data` | list | `[0xFD, 0x04, 0x00, 0x00, 0x00, 0x00]` | 要寫入的資料 |
+| `debug` | bool | `False` | 印出 debug 資訊 |
+
+**回傳值：** `int` — `transactionErrorCode`（0 表示成功）
+
+```python
+dev = ifxusb010.connect_device()
+error_code = ifxusb010.mrw(dev=dev, device_address=0x40, data=[0xFD, 0x04, 0x00, 0x00, 0x00, 0x00])
+```

ifxusb010-0.1.4/main.py

@@ -0,0 +1,18 @@
+from pywinusb import hid
+import wmi
+
+def find_specific_device():
+    # search USB through wmi
+    c = wmi.WMI()
+    usb_devices = c.Win32_PnPEntity(ConfigManagerErrorCode=0)
+    
+    for device in usb_devices:
+        # search 058b
+        if device.DeviceID and '058B' in device.DeviceID.upper(): ## 058B means Infineon 
+            print("found device:")
+            print(f"device name: {device.Name}")
+            
+            print(f"device ID: {device.DeviceID}")
+            print(f"manufacturer : {device.Manufacturer}")
+
+find_specific_device()

ifxusb010-0.1.4/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ifxusb010"
+version = "0.1.4"
+description = "python for Infineon USB010"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "bitarray>=3.8.0",
+    "libusb-package>=1.0.26.3",
+    "pyusb>=1.3.1",
+    "pywinusb>=0.4.2",
+    "wmi>=1.5.1",
+]
+authors = [
+    {name = "a9202507", email = "a9202507@gmail.com"},
+]
+
+[project.optional-dependencies]
+dev = [
+    "mypy>=1.19.1",
+]
+
+[tool.hatch.build.targets.sdist]
+exclude = [
+    ".git",
+    "__pycache__",
+    "*.pyc",
+    "dist",
+    ".env*",
+    ".pypi_test_token",
+    "test_module.py",
+    "usb010_*.py",
+    "*.log",
+    ".DS_Store",
+    "Thumbs.db",
+    "libusb-1.0.29",  # 加入這個
+]

ifxusb010-0.1.4/requirements.txt

@@ -0,0 +1,11 @@
+docutils==0.21.2
+importlib_metadata==8.5.0
+libusb==1.0.27.post3
+packaging==24.2
+pkg_about==1.2.5
+pywin32==308
+pywinusb==0.4.2
+setuptools==75.6.0
+uv==0.5.6
+WMI==1.5.1
+zipp==3.21.0

ifxusb010-0.1.4/src/ifxusb010/__init__.py

@@ -0,0 +1,10 @@
+#from .scanner import search_I2C, connect_device, mrw, multiReadWriteFunction
+#from .scanner import Dongle
+from .dongle import dongle
+from .pmbus import PMBusDevice
+from . import mckinley
+
+
+__all__ = ["dongle","scan_I2C","connect_device","multi_readr_write","PMBusDevice","mckinley","rainier"]
+
+