Archived
docs: Add contribution guidelines and templates for English and Korean
This commit is contained in:
1 parent
94ddb8fdda
commit
e787fab0b5
9 files changed
+349
-2
No files matched your search
@@ -0,0 +1,39 @@
|
||||
---
|
||||
name: "🚗 Vehicle PID Contribution (English)"
|
||||
about: Share your vehicle's working OBD-II PID configuration.
|
||||
title: "[Vehicle] Manufacturer Model (Year)"
|
||||
labels: vehicle-config
|
||||
assignees: ''
|
||||
---
|
||||
|
||||
### 1. Vehicle Information
|
||||
* **Manufacturer**:
|
||||
* **Model**:
|
||||
* **Year**:
|
||||
* **Engine/Fuel Type**: (e.g., Gasoline, Diesel, Hybrid, EV)
|
||||
|
||||
### 2. Connection Settings
|
||||
* **OBD-II Adapter Model**: (e.g., vLinker MC+, ELM327 v1.5)
|
||||
* **OBD Protocol / Init Commands (If any)**: (e.g., `ATSP6`, `ATSP0` or leave blank if standard)
|
||||
|
||||
### 3. Sensor List
|
||||
Please list the OBD PIDs you successfully configured.
|
||||
|
||||
| Sensor Name | Mode | PID | Formula (Decoding) | Unit | Description | Update Interval |
|
||||
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
||||
| *e.g., Engine Oil Temp* | *22* | *1008* | *a - 40* | *°C* | *Engine oil temperature* | *10s* |
|
||||
| | | | | | | |
|
||||
| | | | | | | |
|
||||
|
||||
*Note: In the formula, use `a`, `b`, `c`, `d`, etc., for response bytes.*
|
||||
|
||||
### 4. Raw YAML Draft (Optional)
|
||||
If you have already generated a YAML config draft in the app or wrote one yourself, paste it here:
|
||||
|
||||
```yaml
|
||||
# Paste your YAML snippet here if available
|
||||
```
|
||||
|
||||
### 5. Verification
|
||||
* [ ] I have successfully tested these PIDs in my car using the HassBle app.
|
||||
* Additional comments or screenshots:
|
||||
@@ -0,0 +1,39 @@
|
||||
---
|
||||
name: "🚗 차량 PID 제보 (Korean)"
|
||||
about: 작동 확인된 차량의 OBD-II PID 설정을 공유해 주세요.
|
||||
title: "[Vehicle] 제조사 모델명 (연식)"
|
||||
labels: vehicle-config
|
||||
assignees: ''
|
||||
---
|
||||
|
||||
### 1. 차량 정보
|
||||
* **제조사 (Manufacturer)**:
|
||||
* **모델명 (Model)**:
|
||||
* **연식 (Year)**:
|
||||
* **유종/엔진 형식**: (예: 가솔린, 디젤, 하이브리드, EV)
|
||||
|
||||
### 2. 연결 설정
|
||||
* **OBD-II 어댑터 모델**: (예: vLinker MC+, ELM327 v1.5)
|
||||
* **OBD 프로토콜 / 초기화 명령어**: (예: `ATSP6`, `ATSP0` 또는 표준 규격일 경우 생략 가능)
|
||||
|
||||
### 3. 센서 목록
|
||||
정상 작동 확인된 PID 목록을 작성해 주세요.
|
||||
|
||||
| 센서 이름 (영문 권장) | Mode | PID | 변환 수식 (Formula) | 단위 (Unit) | 설명 | 폴링 주기 |
|
||||
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
|
||||
| *예) engine_oil_temp* | *22* | *1008* | *a - 40* | *°C* | *엔진 오일 온도* | *10s* |
|
||||
| | | | | | | |
|
||||
| | | | | | | |
|
||||
|
||||
*참고: 수식에는 수신 바이트 순서대로 `a`, `b`, `c`, `d` 등을 변수로 사용합니다.*
|
||||
|
||||
### 4. YAML 초안 (선택 사항)
|
||||
앱에서 내보낸 YAML이나 직접 작성한 초안이 있다면 아래에 붙여넣어 주세요.
|
||||
|
||||
```yaml
|
||||
# 여기에 YAML 코드를 붙여넣어 주세요.
|
||||
```
|
||||
|
||||
### 5. 작동 확인 여부
|
||||
* [ ] HassBle 앱을 통해 실제 차량에서 값이 정상적으로 읽히는 것을 확인했습니다.
|
||||
* 추가 설명 및 작동 스크린샷:
|
||||
@@ -0,0 +1,25 @@
|
||||
## Description
|
||||
Please describe the vehicle template or configuration changes you are proposing.
|
||||
|
||||
- Added/Updated Vehicle: E.g., *Hyundai Avante CN7*
|
||||
- Source Type: OBD / BLE Advertisement / GATT
|
||||
- Main Features: E.g., *Added custom Mode 22 PIDs for Oil Temperature and Gear Status*
|
||||
|
||||
---
|
||||
|
||||
## Checklist
|
||||
Before submitting this PR, please check the following:
|
||||
|
||||
- [ ] **Valid YAML Syntax**: The YAML formatting is correct and contains no parser errors.
|
||||
- [ ] **No Hex Literals for IDs**: Used decimal integers for numeric parameters like `manufacturer_id` (e.g., Apple is `76`, not `0x004C`).
|
||||
- [ ] **Unique Template IDs**: The new template ID is unique and doesn't conflict with existing ones in `templates.yaml`.
|
||||
- [ ] **Tested & Verified**: I have tested this configuration in the HassBle app and verified that the sensor data is decoded properly.
|
||||
|
||||
---
|
||||
|
||||
## YAML Code Snippet (Optional)
|
||||
If you've added a new template, you can highlight it below for a quick review:
|
||||
|
||||
```yaml
|
||||
# Put your added template block here
|
||||
```
|
||||
@@ -0,0 +1,25 @@
|
||||
## Description
|
||||
Please describe the vehicle template or configuration changes you are proposing.
|
||||
|
||||
- Added/Updated Vehicle: E.g., *Hyundai Avante CN7*
|
||||
- Source Type: OBD / BLE Advertisement / GATT
|
||||
- Main Features: E.g., *Added custom Mode 22 PIDs for Oil Temperature and Gear Status*
|
||||
|
||||
---
|
||||
|
||||
## Checklist
|
||||
Before submitting this PR, please check the following:
|
||||
|
||||
- [ ] **Valid YAML Syntax**: The YAML formatting is correct and contains no parser errors.
|
||||
- [ ] **No Hex Literals for IDs**: Used decimal integers for numeric parameters like `manufacturer_id` (e.g., Apple is `76`, not `0x004C`).
|
||||
- [ ] **Unique Template IDs**: The new template ID is unique and doesn't conflict with existing ones in `templates.yaml`.
|
||||
- [ ] **Tested & Verified**: I have tested this configuration in the HassBle app and verified that the sensor data is decoded properly.
|
||||
|
||||
---
|
||||
|
||||
## YAML Code Snippet (Optional)
|
||||
If you've added a new template, you can highlight it below for a quick review:
|
||||
|
||||
```yaml
|
||||
# Put your added template block here
|
||||
```
|
||||
@@ -0,0 +1,25 @@
|
||||
## 변경 사항 설명 (Description)
|
||||
제안하시는 차량 템플릿 또는 설정 변경 사항을 설명해 주세요.
|
||||
|
||||
- 추가/업데이트된 차량: 예) *현대 아반떼 CN7*
|
||||
- 소스 타입: OBD / BLE Advertisement / GATT
|
||||
- 주요 기능: 예) *엔진 오일 온도 및 기어 단수 커스텀 Mode 22 PID 추가*
|
||||
|
||||
---
|
||||
|
||||
## 체크리스트 (Checklist)
|
||||
PR을 제출하기 전에 아래 사항들을 확인해 주세요.
|
||||
|
||||
- [ ] **올바른 YAML 문법**: YAML 포맷에 구문 오류가 없습니다.
|
||||
- [ ] **ID 필드에 16진수(Hex) 금지**: `manufacturer_id` 등의 숫자 파라미터에는 `0x...` hex 대신 10진수 정수를 사용했습니다. (예: Apple은 `0x004C` 대신 `76`)
|
||||
- [ ] **템플릿 ID 중복 확인**: 추가한 템플릿의 ID가 `templates.yaml` 내의 기존 ID와 중복되지 않습니다.
|
||||
- [ ] **작동 검증 완료**: HassBle 앱에서 실제로 이 설정을 구동하여 센서 데이터가 올바르게 디코딩되는지 확인했습니다.
|
||||
|
||||
---
|
||||
|
||||
## 추가된 YAML 코드 (선택 사항)
|
||||
새 템플릿이 추가된 경우 아래에 코드를 작성해 주시면 빠른 리뷰에 도움이 됩니다.
|
||||
|
||||
```yaml
|
||||
# 여기에 추가된 템플릿 블록을 붙여넣어 주세요.
|
||||
```
|
||||
Reference in new issue
Block a user