From a5f47e3e6d162550b4a2cbdb958195e69a923730 Mon Sep 17 00:00:00 2001 From: MX <10697207+xMasterX@users.noreply.github.com> Date: Mon, 9 Mar 2026 20:52:18 +0300 Subject: [PATCH] subghz add nord ice protocol --- CHANGELOG.md | 1 + documentation/SubGHzSupportedSystems.md | 3 +- lib/subghz/protocols/nord_ice.c | 350 ++++++++++++++++++++++++ lib/subghz/protocols/nord_ice.h | 109 ++++++++ lib/subghz/protocols/protocol_items.c | 1 + lib/subghz/protocols/protocol_items.h | 1 + 6 files changed, 464 insertions(+), 1 deletion(-) create mode 100644 lib/subghz/protocols/nord_ice.c create mode 100644 lib/subghz/protocols/nord_ice.h diff --git a/CHANGELOG.md b/CHANGELOG.md index 530fd147f..e73a1a45b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,6 @@ ## Main changes - Current API: 87.6 +* SubGHz: Add **Nord ICE** protocol (33 bits, Static) * SubGHz: Add **CAME TOP44FGN** support in CAME TWEE protocol * NFC: Add Mifare Ultralight C Write Support (by @haw8411) * Apps: Build tag (**9mar2026p3**) - **Check out more Apps updates and fixes by following** [this link](https://github.com/xMasterX/all-the-plugins/commits/dev) diff --git a/documentation/SubGHzSupportedSystems.md b/documentation/SubGHzSupportedSystems.md index 5b6e427c8..8c552e9c7 100644 --- a/documentation/SubGHzSupportedSystems.md +++ b/documentation/SubGHzSupportedSystems.md @@ -41,6 +41,7 @@ That list is only for default SubGHz app, apps like *Weather Station* have their - KingGates Stylo 4k `433.92MHz` `AM650` (89 bits, Dynamic, KeeLoq based) - Mastercode `AM650` (36 bits, Static) - Megacode `AM650` (24 bits, Static) +- Nord ICE `433.92MHz` `AM650` (33 bits, Static) - Nero Sketch `AM650` (40 bits, Static) - Nice Flo `433.92MHz` `AM650` (12, 24 bits, Static) - Nice FloR-S `433.92MHz` `AM650` (52 bits, Dynamic) @@ -106,7 +107,7 @@ The following manufacturers have KeeLoq support in Unleashed firmware: - DEA Mio - `433.92MHz` `AM650` (KeeLoq, 64 bits) (modified serial in Hop, uses last 3 digits modifying first one (example - 419 -> C19) - simple learning) - DoorHan - 315MHz, `433.92MHz` `AM650` (KeeLoq, 64 bits) - DTM Neo - `433.92MHz` `AM650` (KeeLoq, 64 bits) (12bit serial part in Hop - simple learning) -- Elmes Poland - `433.92MHz` `AM650` (KeeLoq, 64 bits) (normal learning) +- Elmes Poland - `303, 433.92MHz` `AM650` (KeeLoq, 64 bits) (normal learning) - FAAC RC,XT - `433.92MHz, 868MHz` `AM650` (KeeLoq, 64 bits) (12bit serial part in Hop - normal learning) - Genius Bravo - `433.92MHz` `AM650` (KeeLoq, 64 bits) (12bit serial part in Hop - normal learning) (Genius ECHO, Genius Bravo (Button code 0xB for prog. mode)) - Gibidi - `433.92MHz` `AM650` (KeeLoq, 64 bits) diff --git a/lib/subghz/protocols/nord_ice.c b/lib/subghz/protocols/nord_ice.c new file mode 100644 index 000000000..2e7d0caa9 --- /dev/null +++ b/lib/subghz/protocols/nord_ice.c @@ -0,0 +1,350 @@ +#include "nord_ice.h" +#include "../blocks/const.h" +#include "../blocks/decoder.h" +#include "../blocks/encoder.h" +#include "../blocks/generic.h" +#include "../blocks/math.h" + +#define TAG "SubGhzProtocolNord_Ice" + +static const SubGhzBlockConst subghz_protocol_nord_ice_const = { + .te_short = 300, + .te_long = 800, + .te_delta = 150, + .min_count_bit_for_found = 33, +}; + +struct SubGhzProtocolDecoderNord_Ice { + SubGhzProtocolDecoderBase base; + + SubGhzBlockDecoder decoder; + SubGhzBlockGeneric generic; +}; + +struct SubGhzProtocolEncoderNord_Ice { + SubGhzProtocolEncoderBase base; + + SubGhzProtocolBlockEncoder encoder; + SubGhzBlockGeneric generic; +}; + +typedef enum { + Nord_IceDecoderStepReset = 0, + Nord_IceDecoderStepSaveDuration, + Nord_IceDecoderStepCheckDuration, +} Nord_IceDecoderStep; + +const SubGhzProtocolDecoder subghz_protocol_nord_ice_decoder = { + .alloc = subghz_protocol_decoder_nord_ice_alloc, + .free = subghz_protocol_decoder_nord_ice_free, + + .feed = subghz_protocol_decoder_nord_ice_feed, + .reset = subghz_protocol_decoder_nord_ice_reset, + + .get_hash_data = subghz_protocol_decoder_nord_ice_get_hash_data, + .serialize = subghz_protocol_decoder_nord_ice_serialize, + .deserialize = subghz_protocol_decoder_nord_ice_deserialize, + .get_string = subghz_protocol_decoder_nord_ice_get_string, +}; + +const SubGhzProtocolEncoder subghz_protocol_nord_ice_encoder = { + .alloc = subghz_protocol_encoder_nord_ice_alloc, + .free = subghz_protocol_encoder_nord_ice_free, + + .deserialize = subghz_protocol_encoder_nord_ice_deserialize, + .stop = subghz_protocol_encoder_nord_ice_stop, + .yield = subghz_protocol_encoder_nord_ice_yield, +}; + +const SubGhzProtocol subghz_protocol_nord_ice = { + .name = SUBGHZ_PROTOCOL_NORD_ICE_NAME, + .type = SubGhzProtocolTypeStatic, + .flag = SubGhzProtocolFlag_433 | SubGhzProtocolFlag_AM | SubGhzProtocolFlag_Decodable | + SubGhzProtocolFlag_Load | SubGhzProtocolFlag_Save | SubGhzProtocolFlag_Send, + + .decoder = &subghz_protocol_nord_ice_decoder, + .encoder = &subghz_protocol_nord_ice_encoder, +}; + +void* subghz_protocol_encoder_nord_ice_alloc(SubGhzEnvironment* environment) { + UNUSED(environment); + SubGhzProtocolEncoderNord_Ice* instance = malloc(sizeof(SubGhzProtocolEncoderNord_Ice)); + + instance->base.protocol = &subghz_protocol_nord_ice; + instance->generic.protocol_name = instance->base.protocol->name; + + instance->encoder.repeat = 3; + instance->encoder.size_upload = 128; + instance->encoder.upload = malloc(instance->encoder.size_upload * sizeof(LevelDuration)); + instance->encoder.is_running = false; + return instance; +} + +void subghz_protocol_encoder_nord_ice_free(void* context) { + furi_assert(context); + SubGhzProtocolEncoderNord_Ice* instance = context; + free(instance->encoder.upload); + free(instance); +} + +/** + * Generating an upload from data. + * @param instance Pointer to a SubGhzProtocolEncoderNord_Ice instance + */ +static void subghz_protocol_encoder_nord_ice_get_upload(SubGhzProtocolEncoderNord_Ice* instance) { + furi_assert(instance); + size_t index = 0; + + // Send key and GAP + for(uint8_t i = instance->generic.data_count_bit; i > 0; i--) { + if(bit_read(instance->generic.data, i - 1)) { + // Send bit 1 + instance->encoder.upload[index++] = + level_duration_make(true, (uint32_t)subghz_protocol_nord_ice_const.te_long); + if(i == 1) { + //Send gap if bit was last + instance->encoder.upload[index++] = level_duration_make( + false, (uint32_t)subghz_protocol_nord_ice_const.te_short * 25); + } else { + instance->encoder.upload[index++] = + level_duration_make(false, (uint32_t)subghz_protocol_nord_ice_const.te_short); + } + } else { + // Send bit 0 + instance->encoder.upload[index++] = + level_duration_make(true, (uint32_t)subghz_protocol_nord_ice_const.te_short); + if(i == 1) { + //Send gap if bit was last + instance->encoder.upload[index++] = level_duration_make( + false, (uint32_t)subghz_protocol_nord_ice_const.te_short * 25); + } else { + instance->encoder.upload[index++] = + level_duration_make(false, (uint32_t)subghz_protocol_nord_ice_const.te_long); + } + } + } + + instance->encoder.size_upload = index; + return; +} + +/** + * Analysis of received data + * @param instance Pointer to a SubGhzBlockGeneric* instance + */ +static void subghz_protocol_nord_ice_check_remote_controller(SubGhzBlockGeneric* instance) { + instance->serial = (instance->data >> 15) << 9 | + (instance->data & 0x1FF); // 26 bits for serial + instance->btn = (instance->data >> 9) & 0x3F; // 6 bits for button +} + +SubGhzProtocolStatus + subghz_protocol_encoder_nord_ice_deserialize(void* context, FlipperFormat* flipper_format) { + furi_assert(context); + SubGhzProtocolEncoderNord_Ice* instance = context; + SubGhzProtocolStatus ret = SubGhzProtocolStatusError; + do { + ret = subghz_block_generic_deserialize_check_count_bit( + &instance->generic, + flipper_format, + subghz_protocol_nord_ice_const.min_count_bit_for_found); + if(ret != SubGhzProtocolStatusOk) { + break; + } + // Optional value + flipper_format_read_uint32( + flipper_format, "Repeat", (uint32_t*)&instance->encoder.repeat, 1); + + subghz_protocol_nord_ice_check_remote_controller(&instance->generic); + subghz_protocol_encoder_nord_ice_get_upload(instance); + instance->encoder.is_running = true; + } while(false); + + return ret; +} + +void subghz_protocol_encoder_nord_ice_stop(void* context) { + SubGhzProtocolEncoderNord_Ice* instance = context; + instance->encoder.is_running = false; +} + +LevelDuration subghz_protocol_encoder_nord_ice_yield(void* context) { + SubGhzProtocolEncoderNord_Ice* instance = context; + + if(instance->encoder.repeat == 0 || !instance->encoder.is_running) { + instance->encoder.is_running = false; + return level_duration_reset(); + } + + LevelDuration ret = instance->encoder.upload[instance->encoder.front]; + + if(++instance->encoder.front == instance->encoder.size_upload) { + if(!subghz_block_generic_global.endless_tx) instance->encoder.repeat--; + instance->encoder.front = 0; + } + + return ret; +} + +void* subghz_protocol_decoder_nord_ice_alloc(SubGhzEnvironment* environment) { + UNUSED(environment); + SubGhzProtocolDecoderNord_Ice* instance = malloc(sizeof(SubGhzProtocolDecoderNord_Ice)); + instance->base.protocol = &subghz_protocol_nord_ice; + instance->generic.protocol_name = instance->base.protocol->name; + return instance; +} + +void subghz_protocol_decoder_nord_ice_free(void* context) { + furi_assert(context); + SubGhzProtocolDecoderNord_Ice* instance = context; + free(instance); +} + +void subghz_protocol_decoder_nord_ice_reset(void* context) { + furi_assert(context); + SubGhzProtocolDecoderNord_Ice* instance = context; + instance->decoder.parser_step = Nord_IceDecoderStepReset; +} + +void subghz_protocol_decoder_nord_ice_feed(void* context, bool level, volatile uint32_t duration) { + furi_assert(context); + SubGhzProtocolDecoderNord_Ice* instance = context; + + // Nord ICE Decoder + // 2026.03 - @xMasterX (MMX) + + // Key samples + // + // Serial Btn Serial + // 0x9467688A btn 1 = 10010100011001110 110100 010001010 + // 0x9467308A btn 2 = 10010100011001110 011000 010001010 + // 0x9467628A btn 3 = 10010100011001110 110001 010001010 + // 0x9467648A btn 4 = 10010100011001110 110010 010001010 + + switch(instance->decoder.parser_step) { + case Nord_IceDecoderStepReset: + if((!level) && (DURATION_DIFF(duration, subghz_protocol_nord_ice_const.te_short * 25) < + subghz_protocol_nord_ice_const.te_delta * 11)) { + //Found GAP + instance->decoder.decode_data = 0; + instance->decoder.decode_count_bit = 0; + instance->decoder.parser_step = Nord_IceDecoderStepSaveDuration; + } + break; + case Nord_IceDecoderStepSaveDuration: + if(level) { + instance->decoder.te_last = duration; + instance->decoder.parser_step = Nord_IceDecoderStepCheckDuration; + } else { + instance->decoder.parser_step = Nord_IceDecoderStepReset; + } + break; + case Nord_IceDecoderStepCheckDuration: + if(!level) { + // Bit 0 is short and long timing = 300us HIGH (te_last) and 800us LOW + if((DURATION_DIFF(instance->decoder.te_last, subghz_protocol_nord_ice_const.te_short) < + subghz_protocol_nord_ice_const.te_delta) && + (DURATION_DIFF(duration, subghz_protocol_nord_ice_const.te_long) < + subghz_protocol_nord_ice_const.te_delta)) { + subghz_protocol_blocks_add_bit(&instance->decoder, 0); + instance->decoder.parser_step = Nord_IceDecoderStepSaveDuration; + // Bit 1 is long and short timing = 800us HIGH (te_last) and 300us LOW + } else if( + (DURATION_DIFF(instance->decoder.te_last, subghz_protocol_nord_ice_const.te_long) < + subghz_protocol_nord_ice_const.te_delta) && + (DURATION_DIFF(duration, subghz_protocol_nord_ice_const.te_short) < + subghz_protocol_nord_ice_const.te_delta)) { + subghz_protocol_blocks_add_bit(&instance->decoder, 1); + instance->decoder.parser_step = Nord_IceDecoderStepSaveDuration; + } else if( + // End of the key + DURATION_DIFF(duration, subghz_protocol_nord_ice_const.te_short * 25) < + subghz_protocol_nord_ice_const.te_delta * 11) { + //Found next GAP and add bit 0 or 1 (only bit 0 was found on the remotes) + if((DURATION_DIFF( + instance->decoder.te_last, subghz_protocol_nord_ice_const.te_short) < + subghz_protocol_nord_ice_const.te_delta)) { + subghz_protocol_blocks_add_bit(&instance->decoder, 0); + } + if((DURATION_DIFF( + instance->decoder.te_last, subghz_protocol_nord_ice_const.te_long) < + subghz_protocol_nord_ice_const.te_delta)) { + subghz_protocol_blocks_add_bit(&instance->decoder, 1); + } + // If got 33 bits key reading is finished + if(instance->decoder.decode_count_bit == + subghz_protocol_nord_ice_const.min_count_bit_for_found) { + instance->generic.data = instance->decoder.decode_data; + instance->generic.data_count_bit = instance->decoder.decode_count_bit; + if(instance->base.callback) + instance->base.callback(&instance->base, instance->base.context); + } + instance->decoder.decode_data = 0; + instance->decoder.decode_count_bit = 0; + instance->decoder.parser_step = Nord_IceDecoderStepReset; + } else { + instance->decoder.parser_step = Nord_IceDecoderStepReset; + } + } else { + instance->decoder.parser_step = Nord_IceDecoderStepReset; + } + break; + } +} + +uint8_t subghz_protocol_decoder_nord_ice_get_hash_data(void* context) { + furi_assert(context); + SubGhzProtocolDecoderNord_Ice* instance = context; + return subghz_protocol_blocks_get_hash_data( + &instance->decoder, (instance->decoder.decode_count_bit / 8) + 1); +} + +SubGhzProtocolStatus subghz_protocol_decoder_nord_ice_serialize( + void* context, + FlipperFormat* flipper_format, + SubGhzRadioPreset* preset) { + furi_assert(context); + SubGhzProtocolDecoderNord_Ice* instance = context; + return subghz_block_generic_serialize(&instance->generic, flipper_format, preset); +} + +SubGhzProtocolStatus + subghz_protocol_decoder_nord_ice_deserialize(void* context, FlipperFormat* flipper_format) { + furi_assert(context); + SubGhzProtocolDecoderNord_Ice* instance = context; + return subghz_block_generic_deserialize_check_count_bit( + &instance->generic, + flipper_format, + subghz_protocol_nord_ice_const.min_count_bit_for_found); +} + +void subghz_protocol_decoder_nord_ice_get_string(void* context, FuriString* output) { + furi_assert(context); + SubGhzProtocolDecoderNord_Ice* instance = context; + + subghz_protocol_nord_ice_check_remote_controller(&instance->generic); + + uint64_t code_found_reverse = subghz_protocol_blocks_reverse_key( + instance->generic.data, instance->generic.data_count_bit); + + // for future use + // // push protocol data to global variable + // subghz_block_generic_global.btn_is_available = false; + // subghz_block_generic_global.current_btn = instance->generic.btn; + // subghz_block_generic_global.btn_length_bit = 4; + // // + + furi_string_cat_printf( + output, + "%s %db\r\n" + "Key: 0x%08llX\r\n" + "Yek: 0x%08llX\r\n" + "Serial: 0x%07lX\r\n" + "Btn: %02X", + instance->generic.protocol_name, + instance->generic.data_count_bit, + (uint64_t)(instance->generic.data & 0xFFFFFFFFF), + (code_found_reverse & 0xFFFFFFFFF), + instance->generic.serial, + instance->generic.btn); +} diff --git a/lib/subghz/protocols/nord_ice.h b/lib/subghz/protocols/nord_ice.h new file mode 100644 index 000000000..4149fba7d --- /dev/null +++ b/lib/subghz/protocols/nord_ice.h @@ -0,0 +1,109 @@ +#pragma once + +#include "base.h" + +#define SUBGHZ_PROTOCOL_NORD_ICE_NAME "Nord ICE" + +typedef struct SubGhzProtocolDecoderNord_Ice SubGhzProtocolDecoderNord_Ice; +typedef struct SubGhzProtocolEncoderNord_Ice SubGhzProtocolEncoderNord_Ice; + +extern const SubGhzProtocolDecoder subghz_protocol_nord_ice_decoder; +extern const SubGhzProtocolEncoder subghz_protocol_nord_ice_encoder; +extern const SubGhzProtocol subghz_protocol_nord_ice; + +/** + * Allocate SubGhzProtocolEncoderNord_Ice. + * @param environment Pointer to a SubGhzEnvironment instance + * @return SubGhzProtocolEncoderNord_Ice* pointer to a SubGhzProtocolEncoderNord_Ice instance + */ +void* subghz_protocol_encoder_nord_ice_alloc(SubGhzEnvironment* environment); + +/** + * Free SubGhzProtocolEncoderNord_Ice. + * @param context Pointer to a SubGhzProtocolEncoderNord_Ice instance + */ +void subghz_protocol_encoder_nord_ice_free(void* context); + +/** + * Deserialize and generating an upload to send. + * @param context Pointer to a SubGhzProtocolEncoderNord_Ice instance + * @param flipper_format Pointer to a FlipperFormat instance + * @return status + */ +SubGhzProtocolStatus + subghz_protocol_encoder_nord_ice_deserialize(void* context, FlipperFormat* flipper_format); + +/** + * Forced transmission stop. + * @param context Pointer to a SubGhzProtocolEncoderNord_Ice instance + */ +void subghz_protocol_encoder_nord_ice_stop(void* context); + +/** + * Getting the level and duration of the upload to be loaded into DMA. + * @param context Pointer to a SubGhzProtocolEncoderNord_Ice instance + * @return LevelDuration + */ +LevelDuration subghz_protocol_encoder_nord_ice_yield(void* context); + +/** + * Allocate SubGhzProtocolDecoderNord_Ice. + * @param environment Pointer to a SubGhzEnvironment instance + * @return SubGhzProtocolDecoderNord_Ice* pointer to a SubGhzProtocolDecoderNord_Ice instance + */ +void* subghz_protocol_decoder_nord_ice_alloc(SubGhzEnvironment* environment); + +/** + * Free SubGhzProtocolDecoderNord_Ice. + * @param context Pointer to a SubGhzProtocolDecoderNord_Ice instance + */ +void subghz_protocol_decoder_nord_ice_free(void* context); + +/** + * Reset decoder SubGhzProtocolDecoderNord_Ice. + * @param context Pointer to a SubGhzProtocolDecoderNord_Ice instance + */ +void subghz_protocol_decoder_nord_ice_reset(void* context); + +/** + * Parse a raw sequence of levels and durations received from the air. + * @param context Pointer to a SubGhzProtocolDecoderNord_Ice instance + * @param level Signal level true-high false-low + * @param duration Duration of this level in, us + */ +void subghz_protocol_decoder_nord_ice_feed(void* context, bool level, uint32_t duration); + +/** + * Getting the hash sum of the last randomly received parcel. + * @param context Pointer to a SubGhzProtocolDecoderNord_Ice instance + * @return hash Hash sum + */ +uint8_t subghz_protocol_decoder_nord_ice_get_hash_data(void* context); + +/** + * Serialize data SubGhzProtocolDecoderNord_Ice. + * @param context Pointer to a SubGhzProtocolDecoderNord_Ice instance + * @param flipper_format Pointer to a FlipperFormat instance + * @param preset The modulation on which the signal was received, SubGhzRadioPreset + * @return status + */ +SubGhzProtocolStatus subghz_protocol_decoder_nord_ice_serialize( + void* context, + FlipperFormat* flipper_format, + SubGhzRadioPreset* preset); + +/** + * Deserialize data SubGhzProtocolDecoderNord_Ice. + * @param context Pointer to a SubGhzProtocolDecoderNord_Ice instance + * @param flipper_format Pointer to a FlipperFormat instance + * @return status + */ +SubGhzProtocolStatus + subghz_protocol_decoder_nord_ice_deserialize(void* context, FlipperFormat* flipper_format); + +/** + * Getting a textual representation of the received data. + * @param context Pointer to a SubGhzProtocolDecoderNord_Ice instance + * @param output Resulting text + */ +void subghz_protocol_decoder_nord_ice_get_string(void* context, FuriString* output); diff --git a/lib/subghz/protocols/protocol_items.c b/lib/subghz/protocols/protocol_items.c index 8dfe647b1..416e3524f 100644 --- a/lib/subghz/protocols/protocol_items.c +++ b/lib/subghz/protocols/protocol_items.c @@ -29,6 +29,7 @@ const SubGhzProtocol* const subghz_protocol_registry_items[] = { &subghz_protocol_elplast, &subghz_protocol_treadmill37, &subghz_protocol_beninca_arc, &subghz_protocol_jarolift, &subghz_protocol_ditec_gol4, &subghz_protocol_keyfinder, + &subghz_protocol_nord_ice, }; const SubGhzProtocolRegistry subghz_protocol_registry = { diff --git a/lib/subghz/protocols/protocol_items.h b/lib/subghz/protocols/protocol_items.h index a0214b74f..d9e5f0cd0 100644 --- a/lib/subghz/protocols/protocol_items.h +++ b/lib/subghz/protocols/protocol_items.h @@ -58,3 +58,4 @@ #include "jarolift.h" #include "ditec_gol4.h" #include "keyfinder.h" +#include "nord_ice.h"