Profili modello

Profili modello / Model profiles

IT - Perche esistono i profili

Siamo partiti dall'INT-14-BW perche avevamo hardware, traffico BLE/LAN e letture live da confrontare. I modelli INT moderni pero' non sono tutti "una sonda uguale una temperatura": alcune probe hanno piu sensori food e un sensore ambiente.

Per questo il componente ora separa due concetti:

• sonde fisiche: le probe reali che infili nel cibo o nella station;
• canali temperatura: le letture separate che una probe puo' mostrare nell'app.

INT-14-BW resta il profilo testato. I modelli vicini entrano come sperimentali quando riusiamo davvero il parser, oppure come catalogati quando conosciamo layout e nome ma non abbiamo ancora letture live validate.

IT - Stato attuale

Profilo	Modello app	Sonde fisiche	Canali temperatura attesi	Canali live mappati	Stato
int14_bw	INT-14-BW	4	8	8	testato
int14_bw_wh	INT-14-BW_WH	4	8	8	sperimentale
ing14	ING14	4	8	8	sperimentale
int14s_bw	INT-14S-BW	4	20	20	community-validated, BLE read-only
int14p_bw	INT-14P-BW	4	8	8	sperimentale
int12_bw	INT-12-BW	2	4	4	sperimentale
int12i_bw	INT-12I-BW	2	4	4	sperimentale
int12e_bw	INT-12E-BW	2	10	10	community-validated, BLE read-only (v0.2.6 prerelease)
int11i_b	INT-11I-B	1	1	1	sperimentale, BLE GATT-poll read-only
int11p_b	INT-11P-B	1	2	0	catalogato, non ancora live
int11s_b	INT-11S-B	1	5	0	catalogato, non ancora live
int31_bw	INT-31-BW	1	5	0	catalogato, non ancora live
int33_bw	INT-33-BW	3	13	0	catalogato, non ancora live

IT - Layout attesi

• INT-14-BW: 4 probe, food/internal + ambiente per probe.
• INT-14S-BW: 4 probe, 4 canali food + ambiente per probe.
• INT-12E-BW: 2 probe, 4 canali food + ambiente per probe.
• INT-31-BW: 1 probe, 4 canali food + ambiente.
• INT-33-BW: 2 probe lunghe con 4 food + ambiente, terza probe mini con 3 canali food.
• INT-11S-B: 1 probe, 4 canali food + ambiente.

INT-11I-B non riusa il payload INT-14 da 18 byte. Dal report community di Dmitry/dskudrin viene letto come GATT-poll: ff01 contiene una temperatura sonda in Fahrenheit centesimi little-endian, 2a19 contiene batteria base/booster e batteria sonda. Le write restano disabilitate.

INT-14S-BW ha un parser BLE community-validated grazie a prove su hardware reale. Ogni probe espone Food 1, Food 2, Food 3, Food 4 e Ambient: in totale 20 entita temperatura live. Nel frame esiste anche Internal, un valore aggregato separato che conserviamo nei diagnostici ma non contiamo come sesto sensore fisico. Per questo profilo Wi-Fi/Tuya LAN, cloud e tutte le write restano disabilitati. Anche charging, connected, paired, timer e allarmi sono nascosti finche' il frame di stato specifico INT-14S non viene mappato.

INT-12E-BW ha un parser BLE read-only validato dalla community nella prerelease v0.2.6. Espone Food 1-4 e Ambient per due probe, temperatura station e tre batterie GATT. Le notifiche aggiornano subito le entita; l'intervallo configurabile da 5 a 300 secondi serve solo per la lettura diretta di recupero. La station chiude normalmente la connessione dopo circa 30 secondi con motivo 0x13 e l'integrazione si riconnette. Food 4 e' stato confermato come punta su entrambe le probe; la posizione fisica esatta di Food 1-3 e' ancora da mappare. LAN, cloud, write e stati di protocollo restano spenti.

Questi layout arrivano dalle definizioni modello dell'app vendor. Sono sufficienti per modellare la forma attesa, non per dichiarare supporto live. Per leggere davvero quei canali servono frame BLE, DP Tuya LAN o storico cloud validati su hardware reale.

IT - Cosa cambia scegliendo un profilo

• Home Assistant sa quante sonde fisiche aspettarsi.
• I diagnostici mostrano quanti canali temperatura sono attesi e quanti sono mappati live.
• I profili catalogati non creano sensori temperatura finti sempre sconosciuti.
• Le write vengono bloccate quando il profilo non e' supportato per quel trasporto.
• LAN/cloud vengono abilitate solo se il profilo le dichiara sensate.
• Le diagnostiche batteria valutano il plateau 100% in base al numero reale di sonde fisiche.

IT - Come validare un modello

Per test veloci o dubbi sul profilo usa il form Discussion:

https://github.com/zampix1/ha-inkbird-int14/discussions/new?category=q-a

Per bug riproducibili usa il form Issue:

https://github.com/zampix1/ha-inkbird-int14/issues/new?template=model_validation_report.yml

La pagina Report validazione modello spiega cosa includere e cosa redigere prima di pubblicare.

EN - Why profiles exist

The project started with INT-14-BW because that was the hardware we could test against: BLE/LAN traffic and live readings.

Modern INT models are not always "one probe equals one temperature". Some probes expose several food sensors plus an ambient sensor.

The integration therefore separates:

• physical probes: the real probe bodies/sticks;
• temperature channels: the separate readings shown for a probe.

INT-14-BW remains the tested profile. Related models are experimental when the parser is actually reused, or cataloged when the model name and expected layout are known but live readings are not validated yet.

EN - Current status

Profile	App model	Physical probes	Expected temp channels	Live mapped channels	Status
int14_bw	INT-14-BW	4	8	8	tested
int14_bw_wh	INT-14-BW_WH	4	8	8	experimental
ing14	ING14	4	8	8	experimental
int14s_bw	INT-14S-BW	4	20	20	community-validated, read-only BLE
int14p_bw	INT-14P-BW	4	8	8	experimental
int12_bw	INT-12-BW	2	4	4	experimental
int12i_bw	INT-12I-BW	2	4	4	experimental
int12e_bw	INT-12E-BW	2	10	10	community-validated, read-only BLE (v0.2.6 prerelease)
int11i_b	INT-11I-B	1	1	1	experimental, BLE GATT-poll read-only
int11p_b	INT-11P-B	1	2	0	cataloged, no live reads yet
int11s_b	INT-11S-B	1	5	0	cataloged, no live reads yet
int31_bw	INT-31-BW	1	5	0	cataloged, no live reads yet
int33_bw	INT-33-BW	3	13	0	cataloged, no live reads yet

EN - Expected layouts

• INT-14-BW: 4 probes, food/internal + ambient per probe.
• INT-14S-BW: 4 probes, 4 food channels + ambient per probe.
• INT-12E-BW: 2 probes, 4 food channels + ambient per probe.
• INT-31-BW: 1 probe, 4 food channels + ambient.
• INT-33-BW: 2 long probes with 4 food + ambient, third mini probe with 3 food channels.
• INT-11S-B: 1 probe, 4 food channels + ambient.

INT-11I-B does not reuse the INT-14 18-byte payload. Based on Dmitry/dskudrin's community report it is handled as a GATT-poll device: ff01 contains one probe temperature in little-endian Fahrenheit hundredths, and 2a19 contains base/booster battery and probe battery. Writes remain disabled.

INT-14S-BW has a community-validated BLE parser thanks to real-hardware testing. Each probe exposes Food 1, Food 2, Food 3, Food 4 and Ambient, for 20 live temperature entities in total. The frame also carries a separate Internal aggregate; it is retained in diagnostics but is not counted as a sixth physical sensor. Wi-Fi/Tuya LAN, cloud and every write remain disabled for this profile. Charging, connected, paired, timer and alarm entities are also hidden until the INT-14S-specific state frame is mapped.

INT-12E-BW has a community-validated read-only BLE parser in the v0.2.6 prerelease line. It exposes Food 1-4 and Ambient for two probes, station temperature and three GATT battery values. Notifications update entities immediately; the configurable 5-300 second interval controls only fallback direct reads. The station normally closes each connection after about 30 seconds with reason 0x13, and the integration reconnects. Food 4 is confirmed as the tip on both probes; the exact physical order of Food 1-3 still needs mapping. LAN, cloud, writes and protocol-state entities remain disabled.

These layouts come from vendor app model definitions. They are enough to model the expected shape, not enough to claim live support. Real support needs validated BLE frames, Tuya LAN DPs or cloud history mapping from hardware.

EN - What a profile changes

• Home Assistant knows how many physical probes to expect.
• Diagnostics show expected temperature channels and mapped live channels.
• Cataloged profiles do not create fake temperature sensors that stay unknown forever.
• Writes are blocked when the selected profile is not supported for that transport.
• LAN/cloud paths are enabled only when the profile declares them meaningful.
• Battery diagnostics judge the 100% plateau using the physical probe count.

EN - How to validate a model

For quick tests or profile doubts, use the Discussion form:

https://github.com/zampix1/ha-inkbird-int14/discussions/new?category=q-a

For reproducible bugs, use the Issue form:

https://github.com/zampix1/ha-inkbird-int14/issues/new?template=model_validation_report.yml

The Model validation report page explains what to include and what to redact before posting.