하프 디센트 스케일 웹 앱 소개

하프 디센트 웹 앱

이 컬렉션은 순수 JavaScript, HTML, CSS로 제작된 세 가지 웹 애플리케이션을 소개합니다. 이 앱들은 Web Bluetooth Low Energy(Web BLE), Wi-Fi, Web USB를 통해 사용할 수 있는 다양한 기능을 보여줍니다. 이 앱들은 하프 디센트 스케일과 상호작용하는 새로운 방법을 열어줍니다. 웹 브라우저에서 직접 품질 관리, 정밀 계량, 간소화된 도징을 위한 강력한 도구를 제공합니다.

앱 체험하기: 라이브 데모

저희 웹 도구를 직접 사용해 보십시오. 데스크톱 및 노트북 브라우저와 Android 스마트폰 및 태블릿에서 작동합니다. iPhone 및 iPad에서는 무료 Beacio 앱을 설치한 후 Safari에서 작동합니다. 이 앱은 Safari에 Bluetooth 기능을 추가합니다. 모든 기기는 스케일의 Wi-Fi를 통해서도 연결할 수 있습니다.

계량 및 저장: 일반적인 계량 작업을 위한 대표 앱입니다. 설정된 시간 내에 물품의 무게를 정밀하게 측정하고, 결과를 분석이나 기록 보관을 위해 손쉽게 내보낼 수 있습니다.

품질 관리 어시스턴트: 일관성을 보장하는 데 완벽합니다. 이 앱을 사용하면 동일한 물품을 반복적으로 계량할 수 있어 데이터 추적과 품질 검사가 간편해집니다.

도징 어시스턴트: 정확하고 반복 가능한 측정을 위해 설계된 직관적인 인터페이스로 도징 과정을 간소화하십시오.

칵테일 메이커 : 이 인터랙티브 앱은 유명한 "PDT 칵테일 북"에 수록된 클래식 칵테일을 만드는 모든 단계를 안내해 드립니다.

시작하기: 연결 및 사용 방법

하프 디센트 스케일을 저희 웹 앱에 연결하는 것은 간단합니다. 다음 단계를 따르십시오:

1. 브라우저 확인:

브라우저를 확인하는 것이 필수적입니다. 컴퓨터나 Android에서는 최신 버전의 Google Chrome(버전 136 이상) 또는 Microsoft Edge(버전 136 이상)를 사용하십시오. iPhone 또는 iPad에서는 무료 Beacio 앱을 설치하고 Safari를 사용하십시오. iOS에서는 Safari만 확장 프로그램을 지원합니다.

2. 앱 열기:

위에 제공된 앱 링크 중 하나로 이동하십시오.

3. 페어링 모드 활성화:

하프 디센트 스케일을 Bluetooth 페어링 모드로 전환하십시오.

4. 앱을 통한 연결:
  • 웹 애플리케이션에서 "Connect" 버튼을 클릭하십시오.
  • 사용 가능한 Bluetooth 기기를 나열하는 팝업 창이 나타납니다.
  • 목록에서 "Decent Scale"을 선택하십시오.
    • 5. 연결 확인:

    연결되면 "Connect" 버튼이 빨간색으로 바뀌고 텍스트가 "Disconnect"로 변경됩니다. 또한 화면에 스케일의 실시간 무게 업데이트가 표시됩니다.

    6. 시작:

    "Start" 버튼을 클릭하고 사용 중인 앱에 맞는 화면 안내를 따르십시오.

    USB-C 연결 사용 방법:

    저희 앱은 직접 USB-C 연결도 지원합니다. 이 방법을 선택하시는 경우:

  • 먼저 USB-C 케이블로 기기를 하프 디센트 스케일에 연결하십시오.
  • 다음으로 기기에 CH34X 시리얼 드라이버를 설치하십시오.
  • 드롭다운 메뉴에서 USB 연결을 선택하고 "Connect"를 클릭한 후 팝업 목록에서 "USB Serial"을 선택하십시오.
  • 연결하면 화면에 실시간 무게 업데이트가 표시됩니다.

    • WIFI 연결 사용 방법(펌웨어 3.0.0 필요):

    하프 디센트 스케일은 이제 추가 기능과 연결성을 위해 WiFi를 사용합니다.

  • WiFi 모드를 활성화하려면 HDS 설정 메뉴로 이동하여 "WiFi settings" 항목을 찾으십시오.

    • 여기에서 Wi-Fi를 활성화 또는 비활성화하고 현재 Wi-Fi 정보를 확인할 수 있습니다.

  • WiFi를 켜거나 끄면 새 설정이 적용되도록 스케일을 재시작해야 합니다.

    • HDS는 "Decent Scale"이라는 자체 WiFi를 개방합니다. 이는 '12345678'이라는 비밀번호로 보호됩니다.

  • 이 WiFi에 연결한 후 브라우저를 사용하여 hds.local 또는 192.168.1.1로 이동하여 WiFi 설정을 변경하십시오.

    • hds.local 페이지로 이동하여 WiFi ID와 비밀번호를 입력하여 HDS를 가정용 WiFi(2.4GHz)에 연결하십시오.

    새 설정을 적용하려면 스케일을 재시작하십시오. WiFi 설정을 올바르게 저장하고 HDS를 신호 범위 내에 두십시오. 그렇지 않으면 HDS가 자체 WiFi(Decent Scale)로 돌아가며, 필요 시 설정을 다시 변경할 수 있습니다.

    목적 및 대상

    이 웹 애플리케이션은 두 가지 주요 목표를 수행합니다:

  • 스케일 사용자용: 저희 하프 디센트 스케일 도구는 실용적이고 사용하기 쉽습니다. 일상적인 작업을 위한 스케일의 기능을 향상시킵니다.
  • 개발자용: Web Bluetooth 및 Web USB 기능의 실제 시연은 이러한 기술에 대한 탐구와 혁신을 장려하는 데 필수적입니다.

    • 이 앱은 다음과 같은 분들께 이상적입니다:

  • 디센트 에스프레소 머신 및/또는 하프 디센트 스케일 소유자: 일상적인 계량과 커피 준비 루틴을 극대화하십시오.
  • 품질 관리 전문가: 계량 프로세스를 간소화하고, 일관성을 개선하며, 데이터 수집을 단순화하십시오.
  • 개발자 및 기술 애호가: IoT 환경에서 Web BLE 및 Web USB의 실제 구현을 탐구하십시오.

    • 개발자용: 기술 심층 분석
  • 이 웹 앱의 코드는 openscale 저장소의 web_apps 디렉터리에서 확인할 수 있습니다.
  • 기반: 표준 HTML, CSS, JavaScript로 구축되었습니다.
  • 스타일링: Tailwind CSS는 유틸리티 우선 방식의 스타일링으로, 반응형의 현대적인 인터페이스를 보장합니다. 참고: Tailwind는 CSS 프레임워크이지만 핵심 로직은 순수 JavaScript로 되어 있어 무거운 JS 프레임워크를 피합니다.
  • 연결성:
  • Web Bluetooth API (Web BLE): 하프 디센트 스케일과의 무선 통신을 가능하게 합니다.
  • Web USB API: 대체 유선 연결 방법을 제공합니다.
  • 브라우저 호환성: Google Chrome(버전 136 이상) 또는 Microsoft Edge(버전 136 이상), iOS 및 Safari에서 스케일의 Wi-Fi 연결을 사용하십시오.
  • WIFI (Websocket): 하프 디센트 스케일을 펌웨어 3.0.0으로 업그레이드한 후 위 안내에 따라 활성화하십시오. 이제 HDS는 WebSocket 엔드포인트를 통해 무게 데이터를 브로드캐스트하고 영점 조정 명령을 수신합니다. 예제 코드는 여기에서 확인하십시오.
  • 데이터 저장: 측정값 및 프리셋과 같은 데이터는 브라우저의 로컬 저장소에 로컬로 저장됩니다. 사용자는 데이터를 JSON 또는 CSV 파일로 다운로드할 수 있습니다.

    • 코드 구조 및 주요 모듈

    코드베이스는 이해하기 쉽고 적응 가능하도록 설계되었습니다. "계량 및 저장"과 "도징 어시스턴트" 기능은 모듈식 구조를 자랑하며, "품질 관리 어시스턴트"는 단일 구조를 사용하여 함수 상호작용에 대한 잠재적으로 더 간단한 개요를 제공합니다.

    주요 JavaScript 모듈 및 그 역할:

  • scale.js: BLE 프로토콜, 하프 디센트 스케일(HDS)과의 통신, 핵심 도징 모드 기능을 처리합니다.
  • constants.js: HDS 통신을 위한 사전 프로그래밍된 10바이트 메시지와 다양한 임계값을 저장합니다.
  • state-machine.js: 유한 상태 머신 모델을 사용하여 "도징 어시스턴트"와 "품질 관리 어시스턴트"의 핵심 로직을 구현합니다.
  • export.js: 무게 측정값과 평가 데이터를 CSV 또는 JSON 파일로 내보내는 기능을 관리합니다.
  • presets.js: "도징 어시스턴트"와 "품질 관리 어시스턴트"에서 사용자가 목표 무게를 프리셋으로 저장할 수 있게 하며, 브라우저에 로컬로 캐시됩니다.
  • ui-controller.js: HTML 인터페이스의 업데이트와 변경을 관리합니다.
  • modules/connection : BLE 및 USB 연결 방법의 구체적인 구현을 포함합니다.
  • modules/reconnecting-websocket.js/ : 웹소켓 자동 재연결을 돕는 간단한 모듈로, WiFi 신호가 충분히 강하지 않을 때 사용을 권장합니다.

    • 스케일의 통신 프로토콜에 대한 자세한 내용은 하프 디센트 스케일 프로그래머 가이드를 참조하십시오.

    개발 환경 설정

    로컬 복사본을 받아 실행하려면 다음 간단한 단계를 따르십시오:

    1. web_apps 디렉터리 다운로드: GitHub는 하위 디렉터리에 대한 직접 다운로드를 제공하지 않습니다. 이를 위해 특수 도구를 사용하십시오. 몇 가지 옵션은 다음과 같습니다:
  • DownGit 또는 github1s와 같은 웹 도구를 사용하십시오.
  • 도구의 웹사이트로 이동하십시오.
  • GitHub의 web_apps 디렉터리 URL을 붙여넣으십시오: https://github.com/decentespresso/openscale/tree/main/web_apps
  • 도구의 안내에 따라 디렉터리를 ZIP 파일로 다운로드하십시오.
  • 다운로드한 ZIP 파일의 압축을 푸십시오. web_apps 폴더가 생성됩니다.
    • 2. 프로젝트 디렉터리로 이동:

    cd web_apps/dosing_assistant

    3. 로컬 HTTP 서버로 파일 제공:

    이들은 Web BLE를 사용하는 웹 애플리케이션이므로 https:// 또는 http://localhost를 통해 제공되어야 합니다.

    간단한 NPX HTTP 서버나 원하는 다른 로컬 서버를 사용할 수 있습니다.

  • NPX의 http.server 사용:

    • npx http-server -p 8000

    그런 다음 Chrome 브라우저를 열고 다음 중 하나로 이동하십시오:


    http://localhost:8000/weigh_save.html


    http://localhost:8000/dosing_assistant.html

    이 프로젝트는 오픈소스이며, 개발자 여러분께서 코드베이스를 탐구하고 배우며 기여하시기를 강력히 권장합니다.

    하프 디센트 스케일 매뉴얼: 목차

    #app #opensource #javascript #webweigh #halfdecentscale #bluetooth #usb #decentscale #weighing #wifi



  • 원본 : Introducing Half Decent Scale web apps


    john created 2025/05/30, john updated 2026/11/11