HandsON-BuildHat-API 1.0.5__tar.gz → 1.0.7__tar.gz

{handson_buildhat_api-1.0.5/src/HandsON_BuildHat_API.egg-info → handson_buildhat_api-1.0.7}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: HandsON-BuildHat-API
-Version: 1.0.5
+Version: 1.0.7
 Summary: A third-party API for controlling LEGO SPIKE devices
-Author-email: HaNeul Jung <caffeine.reload@gmail.com>
+Author-email: HaNeul Jung <hnjung@handsontech.co.kr>
 License: Proprietary - Personal/Educational Use Only
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: Other/Proprietary License
@@ -17,7 +17,7 @@ HandsON Build Hat API
 =======
 **Production** : HandsON Technology co., ltd.  
 **Author** : HaNeul Jung (hnjung@handsontech.co.kr)  
-**Last Update** : 2025-08-29
+**Last Update** : 2025-09-01
 
 ## 주의
 2025-08-27 이전 판매된 빌드햇 제품의 경우 1.0.4 버전을 사용  

{handson_buildhat_api-1.0.5 → handson_buildhat_api-1.0.7}/README.md

@@ -2,7 +2,7 @@ HandsON Build Hat API
 =======
 **Production** : HandsON Technology co., ltd.  
 **Author** : HaNeul Jung (hnjung@handsontech.co.kr)  
-**Last Update** : 2025-08-29
+**Last Update** : 2025-09-01
 
 ## 주의
 2025-08-27 이전 판매된 빌드햇 제품의 경우 1.0.4 버전을 사용  

{handson_buildhat_api-1.0.5 → handson_buildhat_api-1.0.7}/pyproject.toml

@@ -1,10 +1,10 @@
 
 [project]
 name = "HandsON-BuildHat-API"
-version = "1.0.5"
+version = "1.0.7"
 description = "A third-party API for controlling LEGO SPIKE devices"
 authors = [
-  { name="HaNeul Jung", email="caffeine.reload@gmail.com" }
+  { name="HaNeul Jung", email="hnjung@handsontech.co.kr" }
 ]
 license = {text = "Proprietary - Personal/Educational Use Only"}
 readme = "README.md"

{handson_buildhat_api-1.0.5 → handson_buildhat_api-1.0.7}/src/HandsON_BuildHat_API/SpikePI.py

@@ -9,8 +9,8 @@ from serial import Serial
 import time
 
 class _ConstButtonID:
-    STOP = 0
-    START = 1
+    START = 0
+    STOP = 1
     
     LEFT = 2
     RIGHT = 3
@@ -37,9 +37,11 @@ class _ConstValue:
 
     ALL_PORT = 0b1111
 
-    MOTOR_PWM_MODE = 0
-    MOTOR_ABS_MODE = 1
-    MOTOR_REL_MODE = 2
+    MOTOR_STOP = 0
+    MOTOR_PWM = 1
+    MOTOR_ABS = 2
+    MOTOR_REL = 3
+    MOTOR_BRAKE = 255
 
 class _PORT:
     PORT = {
@@ -91,7 +93,7 @@ class _SerialManager:
     serial = None
 
     for i in _serial_port:
-        try: serial = Serial(port=i, baudrate=115200, timeout=0.1)
+        try: serial = Serial(port=i, baudrate=115200, timeout=0.02)
         except: pass
         else: break
 
@@ -126,6 +128,7 @@ class _ModuleParent:
             if data == b'': continue
 
             if _Availability.checksum_check(data): return data
+            if ((len(data) == 1) and (data[0] == 0x04)): return data
 
     def _send_data(self, byte:bytes) -> None:
         com = byte
@@ -206,8 +209,8 @@ class Motor(_ModuleParent):
         self._module_check(self._PORT, (_ConstModuleID.SMALL_MOTOR, _ConstModuleID.MEDIUM_MOTOR, _ConstModuleID.LARGE_MOTOR))
 
     def stop(self) -> None:
-        com = bytes((_ConstValue.TRA_DATA + self._PORT, _ConstValue.MOTOR_PWM_MODE, 0, 0))
-        self._send_data(com)
+        com = bytes((_ConstValue.TRA_DATA + self._PORT, _ConstValue.MOTOR_STOP, 0, 0))
+        self._get_data(com)
 
     def start(self, speed:int) -> None:
         if not speed in range(-100, 101):
@@ -216,8 +219,8 @@ class Motor(_ModuleParent):
         if speed > 0: sw = 1
         else: sw = 0
 
-        com = bytes((_ConstValue.TRA_DATA + self._PORT, _ConstValue.MOTOR_PWM_MODE, abs(speed), sw))
-        self._send_data(com)
+        com = bytes((_ConstValue.TRA_DATA + self._PORT, _ConstValue.MOTOR_PWM, abs(speed), sw))
+        self._get_data(com)
 
     def run_to_position(self, degrees, speed) -> None:
         if not speed in range(0, 101):
@@ -228,8 +231,8 @@ class Motor(_ModuleParent):
         if degrees >= 0: target = degrees
         else: target = degrees & 0xFFFF
         
-        com = bytes((_ConstValue.TRA_DATA + self._PORT, _ConstValue.MOTOR_ABS_MODE, speed, (target & 0xFF), (target >> 8)))
-        self._send_data(com)
+        com = bytes((_ConstValue.TRA_DATA + self._PORT, _ConstValue.MOTOR_ABS, speed, (target & 0xFF), (target >> 8)))
+        self._get_data(com)
 
     def run_for_degrees(self, degrees, speed) -> None:
         if not speed in range(0, 101):
@@ -241,8 +244,8 @@ class Motor(_ModuleParent):
         if degrees >= 0: target = degrees
         else: target = degrees & 0xFFFFFFFF
 
-        com = bytes((_ConstValue.TRA_DATA + self._PORT, _ConstValue.MOTOR_REL_MODE, speed, (target & 0xFF), (target >> 8) & 0xFF, (target >> 16) & 0xFF, (target >> 24) & 0xFF))
-        self._send_data(com)
+        com = bytes((_ConstValue.TRA_DATA + self._PORT, _ConstValue.MOTOR_REL, speed, (target & 0xFF), (target >> 8) & 0xFF, (target >> 16) & 0xFF, (target >> 24) & 0xFF))
+        self._get_data(com)
 
     def get_speed(self) -> int:
         command = [_ConstValue.GET_DATA + self._PORT]
@@ -269,8 +272,8 @@ class MotorPair(_ModuleParent):
 
     def stop(self) -> None:
         for i in self._PORTs:
-            com = bytes((_ConstValue.TRA_DATA + i, _ConstValue.MOTOR_PWM_MODE, 0, 0))
-            self._send_data(com)
+            com = bytes((_ConstValue.TRA_DATA + i, _ConstValue.MOTOR_PWM, 0, 0))
+            self._get_data(com)
 
     def start(self, steering, speed) -> None:
         if not steering in range(-100, 101):
@@ -287,8 +290,8 @@ class MotorPair(_ModuleParent):
             if speed > 0: sw = 1
             else: sw = 0
 
-            com = bytes((_ConstValue.TRA_DATA + motor, _ConstValue.MOTOR_PWM_MODE, sw, abs(speed)))
-            self._send_data(com)
+            com = bytes((_ConstValue.TRA_DATA + motor, _ConstValue.MOTOR_PWM, abs(speed), sw))
+            self._get_data(com)
 
     def move(self, degrees, steering, speed) -> None:
         if not steering in range(-100, 101):
@@ -310,8 +313,8 @@ class MotorPair(_ModuleParent):
 
             if count == 1: target = ~target
 
-            com = bytes((_ConstValue.TRA_DATA + motor, _ConstValue.MOTOR_REL_MODE, speed, (target & 0xFF), (target >> 8) & 0xFF, (target >> 16) & 0xFF, (target >> 24) & 0xFF))
-            self._send_data(com)
+            com = bytes((_ConstValue.TRA_DATA + motor, _ConstValue.MOTOR_REL, speed, (target & 0xFF), (target >> 8) & 0xFF, (target >> 16) & 0xFF, (target >> 24) & 0xFF))
+            self._get_data(com)
 
 
     def move_tank(self, degrees, left_speed, right_speed) -> None:
@@ -332,8 +335,8 @@ class MotorPair(_ModuleParent):
 
             if count == 1: target = ~target
 
-            com = bytes((_ConstValue.TRA_DATA + motor, _ConstValue.MOTOR_REL_MODE, speed, (target & 0xFF), (target >> 8) & 0xFF, (target >> 16) & 0xFF, (target >> 24) & 0xFF))
-            self._send_data(com)
+            com = bytes((_ConstValue.TRA_DATA + motor, _ConstValue.MOTOR_REL, speed, (target & 0xFF), (target >> 8) & 0xFF, (target >> 16) & 0xFF, (target >> 24) & 0xFF))
+            self._get_data(com)
 
     def start_tank(self, left_speed, right_speed) -> None:
         if not left_speed in range(-100, 101) or not right_speed in range(-100, 101):
@@ -348,5 +351,5 @@ class MotorPair(_ModuleParent):
             if speed > 0: sw = 1
             else: sw = 0
 
-            com = bytes((_ConstValue.TRA_DATA + motor, _ConstValue.MOTOR_PWM_MODE, sw, abs(speed)))
-            self._send_data(com)
+            com = bytes((_ConstValue.TRA_DATA + motor, _ConstValue.MOTOR_PWM, abs(speed), sw))
+            self._get_data(com)

{handson_buildhat_api-1.0.5 → handson_buildhat_api-1.0.7/src/HandsON_BuildHat_API.egg-info}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: HandsON-BuildHat-API
-Version: 1.0.5
+Version: 1.0.7
 Summary: A third-party API for controlling LEGO SPIKE devices
-Author-email: HaNeul Jung <caffeine.reload@gmail.com>
+Author-email: HaNeul Jung <hnjung@handsontech.co.kr>
 License: Proprietary - Personal/Educational Use Only
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: Other/Proprietary License
@@ -17,7 +17,7 @@ HandsON Build Hat API
 =======
 **Production** : HandsON Technology co., ltd.  
 **Author** : HaNeul Jung (hnjung@handsontech.co.kr)  
-**Last Update** : 2025-08-29
+**Last Update** : 2025-09-01
 
 ## 주의
 2025-08-27 이전 판매된 빌드햇 제품의 경우 1.0.4 버전을 사용