cs_AssetRecord.h

Go to the documentation of this file.

/*
 * Author: Crownstone Team
 * Copyright: Crownstone (https://crownstone.rocks)
 * Date: Aug 17, 2021
 * License: LGPLv3+, Apache License 2.0, and/or MIT (triple-licensed)
 */
 
#pragma once
 
#include <protocol/cs_RssiAndChannel.h>
 
struct __attribute__((__packed__)) asset_record_t {
    asset_id_t assetId;
 
    rssi_and_channel_t myRssi;
 
    uint8_t lastReceivedCounter = 0xFF;
 
    uint8_t throttlingCountdown = 0;
 
#if BUILD_CLOSEST_CROWNSTONE_TRACKER == 1
    stone_id_t nearestStoneId;
 
    int8_t nearestRssi;
#endif
 
    // ------------- record functions -------------
 
    void invalidate() {
        lastReceivedCounter = 0xFF;
    }
 
    bool isValid() {
        return lastReceivedCounter != 0xFF;
    }
 
    asset_id_t id() {
        return assetId;
    }
 
    // ------------- utility functions -------------
 
    void empty() {
        lastReceivedCounter = 0;
        throttlingCountdown = 0;
#if BUILD_CLOSEST_CROWNSTONE_TRACKER == 1
        nearestStoneId = 0;
#endif
    }
 
    bool isThrottled() {
        return throttlingCountdown != 0;
    }
 
    void setThrottlingCountdown(uint8_t ticks) {
        if (ticks >= 0xff) {
            throttlingCountdown = 0xff - 1;
        }
        else {
            throttlingCountdown = ticks;
        }
    }
 
    void addThrottlingCountdown(uint8_t ticks) {
        auto val = uint16_t(throttlingCountdown) + ticks;
        setThrottlingCountdown(val);
    }
};