cs_Microapp.h

Go to the documentation of this file.

/*
 * Author: Crownstone Team
 * Copyright: Crownstone (https://crownstone.rocks)
 * Date: Mar 09, 2021
 * License: LGPLv3+, Apache License 2.0, and/or MIT (triple-licensed)
 */
 
#pragma once
 
#include <events/cs_EventListener.h>
#include <protocol/cs_MicroappPackets.h>
 
class Microapp : public EventListener {
public:
    static Microapp& getInstance() {
        static Microapp instance;
        return instance;
    }
 
    void init(OperationMode operationMode);
 
    bool canRunApp(uint8_t index);
 
    void onExcessiveCallDuration(uint8_t appIndex);
 
private:
    Microapp();
    Microapp(Microapp const&)       = delete;
    void operator=(Microapp const&) = delete;
 
    microapp_state_t _states[g_MICROAPP_COUNT];
 
    bool _started[g_MICROAPP_COUNT] = {};
 
    bool _loaded                  = false;
 
    uint8_t _currentMicroappIndex = MICROAPP_INDEX_NONE;
 
    bool _factoryResetMode        = false;
 
    void loadApps();
 
    void loadState(uint8_t index);
 
    void updateStateFromOperatingData(uint8_t index);
 
    cs_ret_code_t validateApp(uint8_t index);
 
    cs_ret_code_t enableApp(uint8_t index);
 
    cs_ret_code_t startApp(uint8_t index);
 
    void resetState(uint8_t index);
 
    void resetTestState(uint8_t index);
 
    cs_ret_code_t storeState(uint8_t index);
 
    void tick();
 
    cs_ret_code_t handleGetInfo(cs_result_t& result);
    cs_ret_code_t handleUpload(microapp_upload_internal_t* packet);
    cs_ret_code_t handleValidate(microapp_ctrl_header_t* packet);
    cs_ret_code_t handleRemove(microapp_ctrl_header_t* packet);
    cs_ret_code_t handleEnable(microapp_ctrl_header_t* packet);
    cs_ret_code_t handleDisable(microapp_ctrl_header_t* packet);
    cs_ret_code_t handleMessage(microapp_message_internal_t* packet, cs_result_t& result);
 
    cs_ret_code_t checkHeader(microapp_ctrl_header_t* packet);
 
    cs_ret_code_t factoryReset();
 
    cs_ret_code_t resumeFactoryReset();
 
    void onStorageEvent(cs_async_result_t& event);
 
    void handleEvent(event_t& event);
};