sha256.h

Go to the documentation of this file.

/*
 * Copyright (c) 2024 Raspberry Pi (Trading) Ltd.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 */
 
#ifndef _PICO_SHA256_H
#define _PICO_SHA256_H
 
#include "pico/time.h"
#include "hardware/dma.h"
#include "hardware/sha256.h"

 
#ifdef __cplusplus
extern "C" {
#endif

typedef struct pico_sha256_state {
    enum sha256_endianness endianness; 
    int8_t channel;                    
    bool locked;                       
    uint8_t cache_used;                
    union {
        uint32_t word;                 
        uint8_t bytes[4];              
    } cache;                           
    dma_channel_config config;         
    size_t total_data_size;            
} pico_sha256_state_t;

void pico_sha256_cleanup(pico_sha256_state_t *state);

int pico_sha256_try_start(pico_sha256_state_t *state, enum sha256_endianness endianness, bool use_dma);

int pico_sha256_start_blocking_until(pico_sha256_state_t *state, enum sha256_endianness endianness, bool use_dma, absolute_time_t until);

static inline int pico_sha256_start_blocking(pico_sha256_state_t *state, enum sha256_endianness endianness, bool use_dma) {
    return pico_sha256_start_blocking_until(state, endianness, use_dma, at_the_end_of_time);
}

void pico_sha256_update(pico_sha256_state_t *state, const uint8_t *data, size_t data_size_bytes);

void pico_sha256_update_blocking(pico_sha256_state_t *state, const uint8_t *data, size_t data_size_bytes);

void pico_sha256_finish(pico_sha256_state_t *state, sha256_result_t *out);
 
#ifdef __cplusplus
}
#endif
 
#endif