HandsON-BuildHat-API 1.0.6__tar.gz → 1.0.8__tar.gz

{handson_buildhat_api-1.0.6/src/HandsON_BuildHat_API.egg-info → handson_buildhat_api-1.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: HandsON-BuildHat-API
-Version: 1.0.6
+Version: 1.0.8
 Summary: A third-party API for controlling LEGO SPIKE devices
 Author-email: HaNeul Jung <hnjung@handsontech.co.kr>
 License: Proprietary - Personal/Educational Use Only
@@ -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.6 → handson_buildhat_api-1.0.8}/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.6 → handson_buildhat_api-1.0.8}/pyproject.toml

@@ -1,7 +1,7 @@
 
 [project]
 name = "HandsON-BuildHat-API"
-version = "1.0.6"
+version = "1.0.8"
 description = "A third-party API for controlling LEGO SPIKE devices"
 authors = [
   { name="HaNeul Jung", email="hnjung@handsontech.co.kr" }

{handson_buildhat_api-1.0.6 → handson_buildhat_api-1.0.8}/src/HandsON_BuildHat_API/SpikePI.py

@@ -8,9 +8,13 @@
 from serial import Serial
 import time
 
+class _ConstLedID:
+    START_LED = 1
+    STOP_LED = 0
+
 class _ConstButtonID:
-    STOP = 0
-    START = 1
+    START = 0
+    STOP = 1
     
     LEFT = 2
     RIGHT = 3
@@ -31,7 +35,8 @@ class _ConstValue:
     '''
     기타 상수 모음
     '''
-    HUB_DATA = 0b1010 << 4
+    HUB_GET_DATA = 0b1010 << 4
+    HUB_TRA_DATA = 0b1011 << 4
     TRA_DATA = 0b1000 << 4
     GET_DATA = 0b1001 << 4
 
@@ -93,31 +98,12 @@ 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
 
     if serial == None:
         raise Exception('사용 가능한 시리얼 포트를 찾을 수 없습니다.')
-        
-class _button:
-    def __init__(self, button_id = _ConstButtonID.STOP):
-        self.button_id = button_id
-
-    def is_pressed(self):
-        command = b'\xa0\x00\x00\x00\x00\x00\x00'
-        command += _Availability.make_checksum(command)
-        while True:
-            _SerialManager.serial.write(command)
-            data = _SerialManager.serial.read(16)
-            if _Availability.checksum_check(data): break
-        result = True if data[self.button_id + 1] == 1 else False
-        return result
-
-class BuildHat:
-    def __init__(self):
-        self.stop_button = _button(_ConstButtonID.STOP)
-        self.start_button = _button(_ConstButtonID.START)
 
 class _ModuleParent:
     def _get_data(self, byte:bytes) -> bytes:
@@ -128,6 +114,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
@@ -140,6 +127,33 @@ class _ModuleParent:
         command = [_ConstValue.GET_DATA + _ConstValue.ALL_PORT]
         if not self._get_data(byte=bytes(command))[port + 1] in ID:
             raise Exception('해당 포트에 연결된 모듈이 다르거나 없습니다.')
+             
+class _button(_ModuleParent):
+    def __init__(self, button_id = _ConstButtonID.STOP):
+        self.button_id = button_id
+
+    def is_pressed(self):
+        command = [_ConstValue.HUB_GET_DATA]
+        data = self._get_data(bytes(command))
+        result = True if data[1 + self.button_id] == 1 else False
+        return result
+    
+class _led(_ModuleParent):
+    def __init__(self, led_id = _ConstLedID.STOP_LED):
+        self.led_id = led_id
+
+    def set(self, status):
+        command = [_ConstValue.HUB_TRA_DATA, self.led_id, status, 0, 0, 0, 0]
+        self._get_data(bytes(command))
+        return None
+
+class BuildHat:
+    def __init__(self):
+        self.stop_button = _button(_ConstButtonID.STOP)
+        self.start_button = _button(_ConstButtonID.START)
+
+        self.stop_led = _led(_ConstLedID.STOP_LED)
+        self.start_led = _led(_ConstLedID.START_LED)
 
 class ColorSensor(_ModuleParent):
     def __init__(self, port:str):
@@ -209,7 +223,7 @@ class Motor(_ModuleParent):
 
     def stop(self) -> None:
         com = bytes((_ConstValue.TRA_DATA + self._PORT, _ConstValue.MOTOR_STOP, 0, 0))
-        self._send_data(com)
+        self._get_data(com)
 
     def start(self, speed:int) -> None:
         if not speed in range(-100, 101):
@@ -219,7 +233,7 @@ class Motor(_ModuleParent):
         else: sw = 0
 
         com = bytes((_ConstValue.TRA_DATA + self._PORT, _ConstValue.MOTOR_PWM, abs(speed), sw))
-        self._send_data(com)
+        self._get_data(com)
 
     def run_to_position(self, degrees, speed) -> None:
         if not speed in range(0, 101):
@@ -231,7 +245,7 @@ class Motor(_ModuleParent):
         else: target = degrees & 0xFFFF
         
         com = bytes((_ConstValue.TRA_DATA + self._PORT, _ConstValue.MOTOR_ABS, speed, (target & 0xFF), (target >> 8)))
-        self._send_data(com)
+        self._get_data(com)
 
     def run_for_degrees(self, degrees, speed) -> None:
         if not speed in range(0, 101):
@@ -244,7 +258,7 @@ class Motor(_ModuleParent):
         else: target = degrees & 0xFFFFFFFF
 
         com = bytes((_ConstValue.TRA_DATA + self._PORT, _ConstValue.MOTOR_REL, speed, (target & 0xFF), (target >> 8) & 0xFF, (target >> 16) & 0xFF, (target >> 24) & 0xFF))
-        self._send_data(com)
+        self._get_data(com)
 
     def get_speed(self) -> int:
         command = [_ConstValue.GET_DATA + self._PORT]
@@ -271,8 +285,8 @@ class MotorPair(_ModuleParent):
 
     def stop(self) -> None:
         for i in self._PORTs:
-            com = bytes((_ConstValue.TRA_DATA + i, _ConstValue.MOTOR_PWM, 0, 0))
-            self._send_data(com)
+            com = bytes((_ConstValue.TRA_DATA + i, _ConstValue.MOTOR_STOP, 0, 0))
+            self._get_data(com)
 
     def start(self, steering, speed) -> None:
         if not steering in range(-100, 101):
@@ -290,7 +304,7 @@ class MotorPair(_ModuleParent):
             else: sw = 0
 
             com = bytes((_ConstValue.TRA_DATA + motor, _ConstValue.MOTOR_PWM, abs(speed), sw))
-            self._send_data(com)
+            self._get_data(com)
 
     def move(self, degrees, steering, speed) -> None:
         if not steering in range(-100, 101):
@@ -313,7 +327,7 @@ class MotorPair(_ModuleParent):
             if count == 1: target = ~target
 
             com = bytes((_ConstValue.TRA_DATA + motor, _ConstValue.MOTOR_REL, speed, (target & 0xFF), (target >> 8) & 0xFF, (target >> 16) & 0xFF, (target >> 24) & 0xFF))
-            self._send_data(com)
+            self._get_data(com)
 
 
     def move_tank(self, degrees, left_speed, right_speed) -> None:
@@ -335,7 +349,7 @@ class MotorPair(_ModuleParent):
             if count == 1: target = ~target
 
             com = bytes((_ConstValue.TRA_DATA + motor, _ConstValue.MOTOR_REL, speed, (target & 0xFF), (target >> 8) & 0xFF, (target >> 16) & 0xFF, (target >> 24) & 0xFF))
-            self._send_data(com)
+            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):
@@ -351,4 +365,4 @@ class MotorPair(_ModuleParent):
             else: sw = 0
 
             com = bytes((_ConstValue.TRA_DATA + motor, _ConstValue.MOTOR_PWM, abs(speed), sw))
-            self._send_data(com)
+            self._get_data(com)

{handson_buildhat_api-1.0.6 → handson_buildhat_api-1.0.8/src/HandsON_BuildHat_API.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: HandsON-BuildHat-API
-Version: 1.0.6
+Version: 1.0.8
 Summary: A third-party API for controlling LEGO SPIKE devices
 Author-email: HaNeul Jung <hnjung@handsontech.co.kr>
 License: Proprietary - Personal/Educational Use Only
@@ -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 버전을 사용