block.h

Go to the documentation of this file.

/* block.h -- block transfer
 *
 * Copyright (C) 2010--2012 Olaf Bergmann <bergmann@tzi.org>
 *
 * This file is part of the CoAP library libcoap. Please see
 * README for terms of use. 
 */

#ifndef _COAP_BLOCK_H_
#define _COAP_BLOCK_H_

#include "option.h"
#include "encode.h"
#include "pdu.h"

typedef struct {
  unsigned int num:20;      
  unsigned int m:1;     
  unsigned int szx:3;       
} coap_block_t;

#define COAP_OPT_BLOCK_LAST(opt) ( COAP_OPT_VALUE(opt) + (COAP_OPT_LENGTH(opt) - 1) )

#define COAP_OPT_BLOCK_MORE(opt) ( *COAP_OPT_BLOCK_LAST(opt) & 0x08 )

#define COAP_OPT_BLOCK_SZX(opt)  ( *COAP_OPT_BLOCK_LAST(opt) & 0x07 )

static inline unsigned int
_coap_block_num_impl(const coap_opt_t *block_opt) {
  unsigned int num = 0;

  if (COAP_OPT_LENGTH(block_opt) > 1)
    num = coap_decode_var_bytes(COAP_OPT_VALUE(block_opt), 
                COAP_OPT_LENGTH(block_opt) - 1);

  return (num << 4) | ((*COAP_OPT_BLOCK_LAST(block_opt) & 0xF0) >> 4);
}

#define COAP_OPT_BLOCK_NUM(Block) _coap_block_num_impl(Block)

static inline int
coap_more_blocks(size_t data_len, unsigned int num, unsigned short szx) {
  return ((num+1) << (szx + 4)) < data_len;
}

static inline void
coap_opt_block_set_m(coap_opt_t *block_opt, int m) {
  if (m)
    *(COAP_OPT_VALUE(block_opt) + (COAP_OPT_LENGTH(block_opt) - 1)) |= 0x08;
  else
    *(COAP_OPT_VALUE(block_opt) + (COAP_OPT_LENGTH(block_opt) - 1)) &= ~0x08;
}

int coap_get_block(coap_pdu_t *pdu, unsigned short type, coap_block_t *block);

int coap_write_block_opt(coap_block_t *block, unsigned short type,
             coap_pdu_t *pdu, size_t data_length);

int coap_add_block(coap_pdu_t *pdu, unsigned int len, const unsigned char *data,
           unsigned int block_num, unsigned char block_szx);
#endif /* _COAP_BLOCK_H_ */