Create Pixoo64.md
This commit is contained in:
Akamaru
337
Pixoo64.md
Normal file
337
Pixoo64.md
Normal file
@@ -0,0 +1,337 @@
|
|||||||
|
# Divoom Pixoo64 Update API Research
|
||||||
|
|
||||||
|
Dokumentation der Recherche für eine potenzielle RSS-Bridge für Pixoo64 Firmware-Updates.
|
||||||
|
|
||||||
|
## Zusammenfassung
|
||||||
|
|
||||||
|
Die offizielle Divoom API für Firmware-Updates ist **nicht öffentlich zugänglich** und benötigt Authentifizierung mit einem registrierten Gerät. Eine RSS-Bridge ohne physisches Gerät ist daher **nicht umsetzbar**.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Gefundene API-Endpoints
|
||||||
|
|
||||||
|
### Base URLs
|
||||||
|
Aus der dekompilierten APK (`com.divoom.Divoom`) gefunden:
|
||||||
|
|
||||||
|
- `https://appin.divoom-gz.com` - Haupt-API (international)
|
||||||
|
- `https://app.divoom-gz.com` - Alternative API
|
||||||
|
- `https://appchina.divoom-gz.com` - China-spezifisch
|
||||||
|
- `https://appusa.divoom-gz.com` - USA-spezifisch
|
||||||
|
- `https://apptest.divoom-gz.com` - Test-Umgebung
|
||||||
|
- `https://f.divoom-gz.com` - File Downloads
|
||||||
|
- `https://ai.divoom-gz.com` - KI-Features
|
||||||
|
|
||||||
|
### Update-Endpoints
|
||||||
|
|
||||||
|
Aus APK-Analyse (`classes.dex`):
|
||||||
|
|
||||||
|
```
|
||||||
|
Device/GetUpdateInfo - Firmware Update-Informationen
|
||||||
|
Device/GetUpdateFileList - Liste verfügbarer Update-Dateien
|
||||||
|
Device/GetFileVersion - Aktuelle Firmware-Version des Geräts
|
||||||
|
Device/NotifyUpdate - Update-Benachrichtigungen
|
||||||
|
GetNewAppVersion - App-Versions-Updates
|
||||||
|
GetUpdateFileV3 - Update-Datei Download (Version 3)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Request/Response-Klassen (gefunden in DEX)
|
||||||
|
|
||||||
|
```java
|
||||||
|
// Requests
|
||||||
|
com.divoom.Divoom.http.request.device.DeviceGetUpdateInfoRequest
|
||||||
|
com.divoom.Divoom.http.request.device.DeviceGetUpdateFileListRequest
|
||||||
|
com.divoom.Divoom.http.request.device.DeviceGetFileVersionRequest
|
||||||
|
com.divoom.Divoom.http.request.update.GetNewAppVersionRequest
|
||||||
|
|
||||||
|
// Responses
|
||||||
|
com.divoom.Divoom.http.response.device.DeviceGetUpdateInfoResponse
|
||||||
|
com.divoom.Divoom.http.response.device.DeviceGetUpdateFileListResponse
|
||||||
|
com.divoom.Divoom.http.response.update.GetNewAppVersionResponse
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## API-Tests
|
||||||
|
|
||||||
|
### Test 1: GetUpdateInfo (ohne Parameter)
|
||||||
|
```bash
|
||||||
|
curl -X POST "https://appin.divoom-gz.com/Device/GetUpdateInfo" \
|
||||||
|
-H "Content-Type: application/json" -d '{}'
|
||||||
|
```
|
||||||
|
|
||||||
|
**Response:**
|
||||||
|
```json
|
||||||
|
{"ReturnCode":11,"ReturnMessage":"Token is not match"}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Test 2: GetUpdateInfo (mit DeviceType)
|
||||||
|
```bash
|
||||||
|
curl -X POST "https://appin.divoom-gz.com/Device/GetUpdateInfo" \
|
||||||
|
-H "Content-Type: application/json" -d '{"DeviceType": 1}'
|
||||||
|
```
|
||||||
|
|
||||||
|
**Response:**
|
||||||
|
```json
|
||||||
|
{"ReturnCode":1,"ReturnMessage":"no device"}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Test 3: GetUpdateFileList
|
||||||
|
```bash
|
||||||
|
curl -X GET "https://appin.divoom-gz.com/Device/GetUpdateFileList"
|
||||||
|
```
|
||||||
|
|
||||||
|
**Response:**
|
||||||
|
```json
|
||||||
|
{"ReturnCode":1,"ReturnMessage":"Failed"}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Test 4: GetNewAppVersion
|
||||||
|
```bash
|
||||||
|
curl -X POST "https://appin.divoom-gz.com/GetNewAppVersion" \
|
||||||
|
-H "Content-Type: application/json" -d '{}'
|
||||||
|
```
|
||||||
|
|
||||||
|
**Response:**
|
||||||
|
```json
|
||||||
|
{"ReturnCode":3,"ReturnMessage":"Request data is incomplete"}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Authentifizierungs-Anforderungen
|
||||||
|
|
||||||
|
### Aus APK-Analyse identifizierte Parameter:
|
||||||
|
|
||||||
|
**Device-Parameter:**
|
||||||
|
- `DeviceId` - Eindeutige Geräte-ID
|
||||||
|
- `DeviceType` - Gerätetyp (Pixoo64, Pixoo16, etc.)
|
||||||
|
- `DeviceModel` - Modellnummer
|
||||||
|
- `BluetoothDeviceId` - Bluetooth-Gerät-ID
|
||||||
|
|
||||||
|
**Auth-Parameter:**
|
||||||
|
- `Token` - Authentifizierungs-Token
|
||||||
|
- Wird bei `ReturnCode: 11` mit "Token is not match" abgelehnt
|
||||||
|
|
||||||
|
### Error-Codes:
|
||||||
|
- `ReturnCode: 1` - "Failed" / "no device"
|
||||||
|
- `ReturnCode: 3` - "Request data is incomplete"
|
||||||
|
- `ReturnCode: 10` - "Command is not match"
|
||||||
|
- `ReturnCode: 11` - "Token is not match"
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Device-Typen (aus APK)
|
||||||
|
|
||||||
|
```java
|
||||||
|
DeviceTypeEnum {
|
||||||
|
PIXOO_64,
|
||||||
|
PIXOO_16,
|
||||||
|
PIXOO_MAX,
|
||||||
|
TIMEBOX_EVO,
|
||||||
|
// weitere...
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Externe Ressourcen
|
||||||
|
|
||||||
|
### Reddit-Post
|
||||||
|
**URL:** https://old.reddit.com/r/Divoom/comments/1i7fe1u/privacy_check/
|
||||||
|
|
||||||
|
**Gefundene Server-Adressen:**
|
||||||
|
```
|
||||||
|
api.divoom-gz.com
|
||||||
|
appin.divoom-gz.com
|
||||||
|
fin.divoom-gz.com
|
||||||
|
min-api.cryptocompare.com # Crypto-Preise
|
||||||
|
qt.gtimg.cn # Aktien-Kurse
|
||||||
|
www.googleapis.com # YouTube/Wetter
|
||||||
|
```
|
||||||
|
|
||||||
|
### GitHub-Projekte
|
||||||
|
|
||||||
|
#### 1. Pixoo64-Advanced-Tools
|
||||||
|
**URL:** https://github.com/tidyhf/Pixoo64-Advanced-Tools
|
||||||
|
|
||||||
|
**Relevante Findings:**
|
||||||
|
- Python-Tool für lokale Steuerung
|
||||||
|
- Nutzt `pixoo` und `pixoo1664` Libraries
|
||||||
|
- Cloud API-Endpoints gefunden:
|
||||||
|
```python
|
||||||
|
DIV_BASE_URL = "https://app.divoom-gz.com"
|
||||||
|
DIV_FILE_URL = "https://f.divoom-gz.com"
|
||||||
|
```
|
||||||
|
- Endpoints:
|
||||||
|
- `/User/UserLogin` - Login
|
||||||
|
- `/GetCategoryFileListV2` - Gallery
|
||||||
|
- `/Comment/GetCommentListV3` - Kommentare
|
||||||
|
- `/Cloud/GetLikeUserList` - Likes
|
||||||
|
|
||||||
|
#### 2. pixoo-homeassistant
|
||||||
|
**URL:** https://github.com/gickowtf/pixoo-homeassistant
|
||||||
|
|
||||||
|
**Info:**
|
||||||
|
- Home Assistant Integration
|
||||||
|
- Lokale IP-basierte Kommunikation
|
||||||
|
- Keine Firmware-Update-Features
|
||||||
|
|
||||||
|
#### 3. pixoo_api (APK Reverse Engineering)
|
||||||
|
**URL:** https://github.com/Grayda/pixoo_api/blob/main/NOTES.md
|
||||||
|
|
||||||
|
**Relevante Endpoints aus decompilierter APK:**
|
||||||
|
- `Device/GetUpdateInfo`
|
||||||
|
- `Device/GetUpdateFileList`
|
||||||
|
- `Device/NotifyUpdate`
|
||||||
|
- `GetNewAppVersion`
|
||||||
|
- `GetUpdateFileV3`
|
||||||
|
|
||||||
|
**Dokumentation:**
|
||||||
|
- Base URL: `https://appin.divoom-gz.com/`
|
||||||
|
- Undokumentierte Remote API
|
||||||
|
- Verschlüsselung: AES mit Key/IV aus APK
|
||||||
|
|
||||||
|
#### 4. Firmware-Repository
|
||||||
|
**URL:** https://github.com/amnemonic/Pixoo64
|
||||||
|
|
||||||
|
**Verfügbare Versionen:**
|
||||||
|
```
|
||||||
|
V90122 - 27 Jul 2022
|
||||||
|
V90126 - 21 Aug 2022
|
||||||
|
V90127 - 02 Sep 2022
|
||||||
|
V90136 - 06 Nov 2022
|
||||||
|
V90146 - 28 Nov 2022
|
||||||
|
V90149 - 26 Dec 2022
|
||||||
|
V90153 - 05 Jan 2023
|
||||||
|
V90156 - 05 Jan 2023
|
||||||
|
V90165 - 23 Mar 2023
|
||||||
|
V90166 - 29 Mar 2023
|
||||||
|
V90167 - 03 Apr 2023
|
||||||
|
V90180 - 27 Jul 2023
|
||||||
|
V90181 - 28 Aug 2023
|
||||||
|
V90192 - 25 Apr 2024
|
||||||
|
V90205 - 15 Feb 2025
|
||||||
|
```
|
||||||
|
|
||||||
|
**Limitations:**
|
||||||
|
- Keine offiziellen Releases
|
||||||
|
- Keine Changelogs
|
||||||
|
- Nur binäre Firmware-Dateien
|
||||||
|
- Unvollständige Sammlung (laut README)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## APK-Analyse Details
|
||||||
|
|
||||||
|
### Analysierte APK
|
||||||
|
- **Package:** `com.divoom.Divoom`
|
||||||
|
- **Pfad:** `/mnt/d/GitHub/Bridges/com_divoom_Divoom/`
|
||||||
|
- **DEX-Dateien:** 4 (classes.dex, classes2-4.dex)
|
||||||
|
|
||||||
|
### Extraktions-Methoden
|
||||||
|
```bash
|
||||||
|
# URLs extrahieren
|
||||||
|
strings classes*.dex | grep "divoom-gz.com"
|
||||||
|
|
||||||
|
# API-Endpoints finden
|
||||||
|
strings classes*.dex | grep -E "(Device/|Update/|GetNew)"
|
||||||
|
|
||||||
|
# Request/Response-Klassen
|
||||||
|
strings classes*.dex | grep "Request\|Response"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Weitere gefundene Endpoints (nicht Update-bezogen)
|
||||||
|
```
|
||||||
|
User/UserLogin
|
||||||
|
Cloud/GetLikeUserList
|
||||||
|
Comment/GetCommentListV3
|
||||||
|
GetCategoryFileListV2
|
||||||
|
SocialPlatform/* (OAuth für Twitter, Reddit, TikTok, etc.)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Mögliche zukünftige Ansätze
|
||||||
|
|
||||||
|
### Option 1: GitHub-Repository überwachen
|
||||||
|
- **Pro:** Öffentlich zugänglich, keine Auth nötig
|
||||||
|
- **Contra:**
|
||||||
|
- Keine Changelogs
|
||||||
|
- Unvollständige Sammlung
|
||||||
|
- Manuelle Updates durch Community
|
||||||
|
|
||||||
|
**Implementation:**
|
||||||
|
```php
|
||||||
|
// GitHub Commits API
|
||||||
|
$url = "https://api.github.com/repos/amnemonic/Pixoo64/commits";
|
||||||
|
// oder Atom Feed:
|
||||||
|
$url = "https://github.com/amnemonic/Pixoo64/commits/master.atom";
|
||||||
|
```
|
||||||
|
|
||||||
|
### Option 2: APK-Updates überwachen
|
||||||
|
- APKPure/APKMirror für App-Versionen
|
||||||
|
- Indirekte Information über neue Features
|
||||||
|
|
||||||
|
### Option 3: Mit physischem Gerät
|
||||||
|
Wenn Zugriff auf ein Pixoo64:
|
||||||
|
1. Gerät in App registrieren
|
||||||
|
2. Token/DeviceId aus App extrahieren
|
||||||
|
3. API-Calls mit valider Auth
|
||||||
|
|
||||||
|
**Token-Extraktion:**
|
||||||
|
```bash
|
||||||
|
# Aus Android App-Daten (Root erforderlich)
|
||||||
|
adb shell
|
||||||
|
cd /data/data/com.divoom.Divoom/shared_prefs/
|
||||||
|
cat *.xml | grep -i "token\|deviceid"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Option 4: Divoom-Website Scraping
|
||||||
|
- Falls offizielle Changelog-Seite existiert
|
||||||
|
- Keine API-Auth nötig
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Lokale API (Device)
|
||||||
|
|
||||||
|
### Dokumentation
|
||||||
|
**URL:** http://doc.divoom-gz.com/web/#/12?page_id=196
|
||||||
|
|
||||||
|
**Info:**
|
||||||
|
- Lokale HTTP-API auf Pixoo64-Gerät
|
||||||
|
- Direkter Netzwerk-Zugriff (IP-basiert)
|
||||||
|
- Keine Firmware-Update-Funktionen
|
||||||
|
- Nur für Display-Steuerung
|
||||||
|
|
||||||
|
**Kategorien:**
|
||||||
|
- Dial control
|
||||||
|
- Channel control
|
||||||
|
- System settings
|
||||||
|
- Tool functions
|
||||||
|
- Animation functions
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Fazit
|
||||||
|
|
||||||
|
Eine **RSS-Bridge für Pixoo64 Firmware-Updates ist derzeit nicht realisierbar**, da:
|
||||||
|
|
||||||
|
1. Alle Update-APIs benötigen Device-Authentifizierung
|
||||||
|
2. Kein öffentlicher Changelog verfügbar
|
||||||
|
3. GitHub-Repo ist unvollständig und Community-maintained
|
||||||
|
|
||||||
|
**Empfehlung:** Warten auf:
|
||||||
|
- Offizielle Divoom Changelog-Seite
|
||||||
|
- Öffentliche API-Dokumentation
|
||||||
|
- Vollständigeres GitHub-Repository
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Kontakt
|
||||||
|
|
||||||
|
**Divoom Support:**
|
||||||
|
- Website: https://divoom.com
|
||||||
|
- Developer Email: developer@divoom.com (laut APK)
|
||||||
|
- Support: https://divoom.com/apps/help-center
|
||||||
|
|
||||||
|
**Recherche durchgeführt:** 2025-01-25 via Claude Code
|
||||||
Reference in New Issue
Block a user