File content as of revision 1:9f05dbd1c2c7:

/**
 * @file    SplitterAssembler.h
 * @brief   data buffer splitter and assembler header
 * @author  Doug Anson
 * @version 1.0
 * @see     
 *
 * Copyright (c) 2014
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 
#ifndef __SPLITTER_ASSEMBLER_H__
#define __SPLITTER_ASSEMBLER_H__

#include "mbed.h"

// TUNABLES
#define MAX_FRAGMENTS           100     // maximum number of supported fragments... increase as needed...
#define DEF_FRAGMENT_LENGTH     20      // Typically identical to BLE_UART_SERVICE_MAX_DATA_LEN in UARTService.h

class SplitterAssembler {
    public:
        /**
        Constructor
        */
        SplitterAssembler();
        
        /**
        Split a data stream into "n" fragments of the given input fragement (from constructor) size
        @param data input input data buffer
        @param data_length input input data buffer length
        @returns number of fragments created for the input buffer
        */
        int split(uint8_t *data,int data_length);
        
        /**
        Get the ith fragment
        @param index input the ith index value
        @return the ith fragment pointer (null terminated)
        */
        uint8_t *get(int index);
        
        /**
        Reset the Fragmenter/Assembler
        */
        void reset(void);
        
        /**
        Add a fragment
        @param fragment input fragment to add 
        @param fragment_length input the input fragment length (sanity checks...)
        @return the number of fragments currently stored
        */
        int add(uint8_t *fragment,int fragment_length);
        
        /**
        Assemble fragments
        @param buffer input the result buffer
        @param buffer_length input the result buffer length (maximum)
        @param reset_after_assemble input reset the Fragmenter/Assembler after assembly is complete (default: TRUE)
        */
        void assemble(uint8_t *buffer,int buffer_length,bool reset_after_assemble = true);
        
    private:
        int     calculateNumFragments(uint8_t *data,int data_length);
        int     calculateAssemblyLength(int buffer_length);
        void    dump(void);
        
        int     m_num_fragments;
        int     m_last_fragment_length;
        uint8_t m_fragments[DEF_FRAGMENT_LENGTH+1][MAX_FRAGMENTS];
};

#endif // __SPLITTER_ASSEMBLER_H__