Darien Figueroa / Mbed OS Final_Program

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependencies:   USBDevice

HSP/RpcServer/StringHelper.h@0:832122ce6748, 2021-04-07 (annotated)

Committer:
darienf
Date:
Wed Apr 07 22:37:59 2021 +0000
Revision:
0:832122ce6748
painnie

Who changed what in which revision?

UserRevisionLine numberNew contents of line
darienf 0:832122ce6748 1 /*******************************************************************************
darienf 0:832122ce6748 2 * Copyright (C) 2016 Maxim Integrated Products, Inc., All Rights Reserved.
darienf 0:832122ce6748 3 *
darienf 0:832122ce6748 4 * Permission is hereby granted, free of charge, to any person obtaining a
darienf 0:832122ce6748 5 * copy of this software and associated documentation files (the "Software"),
darienf 0:832122ce6748 6 * to deal in the Software without restriction, including without limitation
darienf 0:832122ce6748 7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
darienf 0:832122ce6748 8 * and/or sell copies of the Software, and to permit persons to whom the
darienf 0:832122ce6748 9 * Software is furnished to do so, subject to the following conditions:
darienf 0:832122ce6748 10 *
darienf 0:832122ce6748 11 * The above copyright notice and this permission notice shall be included
darienf 0:832122ce6748 12 * in all copies or substantial portions of the Software.
darienf 0:832122ce6748 13 *
darienf 0:832122ce6748 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
darienf 0:832122ce6748 15 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
darienf 0:832122ce6748 16 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
darienf 0:832122ce6748 17 * IN NO EVENT SHALL MAXIM INTEGRATED BE LIABLE FOR ANY CLAIM, DAMAGES
darienf 0:832122ce6748 18 * OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
darienf 0:832122ce6748 19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
darienf 0:832122ce6748 20 * OTHER DEALINGS IN THE SOFTWARE.
darienf 0:832122ce6748 21 *
darienf 0:832122ce6748 22 * Except as contained in this notice, the name of Maxim Integrated
darienf 0:832122ce6748 23 * Products, Inc. shall not be used except as stated in the Maxim Integrated
darienf 0:832122ce6748 24 * Products, Inc. Branding Policy.
darienf 0:832122ce6748 25 *
darienf 0:832122ce6748 26 * The mere transfer of this software does not imply any licenses
darienf 0:832122ce6748 27 * of trade secrets, proprietary technology, copyrights, patents,
darienf 0:832122ce6748 28 * trademarks, maskwork rights, or any other form of intellectual
darienf 0:832122ce6748 29 * property whatsoever. Maxim Integrated Products, Inc. retains all
darienf 0:832122ce6748 30 * ownership rights.
darienf 0:832122ce6748 31 *******************************************************************************
darienf 0:832122ce6748 32 */
darienf 0:832122ce6748 33 #ifndef _STRINGHELPER_H_
darienf 0:832122ce6748 34 #define _STRINGHELPER_H_
darienf 0:832122ce6748 35
darienf 0:832122ce6748 36 #include "mbed.h"
darienf 0:832122ce6748 37
darienf 0:832122ce6748 38 /**
darienf 0:832122ce6748 39 * @brief Process an array of hex alpha numeric strings representing arguments of
darienf 0:832122ce6748 40 * type uint8
darienf 0:832122ce6748 41 * @param args Array of strings to process
darienf 0:832122ce6748 42 * @param argsUintPtr Pointer of uint8 to save converted arguments
darienf 0:832122ce6748 43 * @param numberOf Number of strings to convert
darienf 0:832122ce6748 44 */
darienf 0:832122ce6748 45 void ProcessArgs(char args[32][32], uint8_t *argsUintPtr, int numberOf);
darienf 0:832122ce6748 46 /**
darienf 0:832122ce6748 47 * @brief Format a binary 8-bit array into a string
darienf 0:832122ce6748 48 * @param uint8Ptr byte buffer to process
darienf 0:832122ce6748 49 * @param numberOf number of bytes in the buffer
darienf 0:832122ce6748 50 * @param reply an array of strings to place the converted array values into
darienf 0:832122ce6748 51 */
darienf 0:832122ce6748 52 void FormatReply(uint8_t *uint8Ptr, int numberOf, char reply[32][32]);
darienf 0:832122ce6748 53 /**
darienf 0:832122ce6748 54 * @brief Process an array of hex alpha numeric strings representing arguments of
darienf 0:832122ce6748 55 * type uint32
darienf 0:832122ce6748 56 * @param args Array of strings to process
darienf 0:832122ce6748 57 * @param argsUintPtr Pointer of uint32 to save converted arguments
darienf 0:832122ce6748 58 * @param numberOf Number of strings to convert
darienf 0:832122ce6748 59 */
darienf 0:832122ce6748 60 void ProcessArgs32(char args[32][32], uint32_t *argsUintPtr, int numberOf);
darienf 0:832122ce6748 61 /**
darienf 0:832122ce6748 62 * @brief Process an array of decimal numeric strings representing arguments of
darienf 0:832122ce6748 63 * type uint32
darienf 0:832122ce6748 64 * @param args Array of strings to process
darienf 0:832122ce6748 65 * @param argsUintPtr Pointer of uint32 to save converted arguments
darienf 0:832122ce6748 66 * @param numberOf Number of strings to convert
darienf 0:832122ce6748 67 */
darienf 0:832122ce6748 68 void ProcessArgs32Dec(char args[32][32], uint32_t *argsUintPtr, int numberOf);
darienf 0:832122ce6748 69 /**
darienf 0:832122ce6748 70 * @brief Format a binary 32-bit array into a string
darienf 0:832122ce6748 71 * @param uint32Ptr 32-bit value buffer to process
darienf 0:832122ce6748 72 * @param numberOf number of values in the buffer
darienf 0:832122ce6748 73 * @param reply an array of strings to place the converted array values into
darienf 0:832122ce6748 74 */
darienf 0:832122ce6748 75 void FormatReply32(uint32_t *uint32Ptr, int numberOf, char reply[32][32]);
darienf 0:832122ce6748 76 /**
darienf 0:832122ce6748 77 * @brief Parse an incoming string hex value into an 8-bit value
darienf 0:832122ce6748 78 * @param str string to process
darienf 0:832122ce6748 79 * @returns 8-bit byte that is parsed from the string
darienf 0:832122ce6748 80 */
darienf 0:832122ce6748 81 uint8_t StringToByte(char str[32]);
darienf 0:832122ce6748 82 /**
darienf 0:832122ce6748 83 * @brief Parse an incoming string hex value into 32-bit value
darienf 0:832122ce6748 84 * @param str string to process
darienf 0:832122ce6748 85 * @returns 32-bit value that is parsed from the string
darienf 0:832122ce6748 86 */
darienf 0:832122ce6748 87 uint32_t StringToInt(char str[32]);
darienf 0:832122ce6748 88 /**
darienf 0:832122ce6748 89 * @brief Parse a single string in decimal format to a uint32 number
darienf 0:832122ce6748 90 * @param str String to process
darienf 0:832122ce6748 91 * @returns Returns the converted number of type uint32
darienf 0:832122ce6748 92 */
darienf 0:832122ce6748 93 uint32_t ParseAsciiDecU32(char *str);
darienf 0:832122ce6748 94 /**
darienf 0:832122ce6748 95 * @brief Parse a single string in hex format to a uint32 number
darienf 0:832122ce6748 96 * @param str String to process
darienf 0:832122ce6748 97 * @returns Returns the converted number of type uint32
darienf 0:832122ce6748 98 */
darienf 0:832122ce6748 99 uint32_t ParseAsciiHexU32(char *str);
darienf 0:832122ce6748 100 /**
darienf 0:832122ce6748 101 * @brief Format a binary 8-bit array into a string
darienf 0:832122ce6748 102 * @param data 8-bit value buffer to process
darienf 0:832122ce6748 103 * @param length number of values in the buffer
darienf 0:832122ce6748 104 * @param str output string buffer
darienf 0:832122ce6748 105 * @return output string
darienf 0:832122ce6748 106 */
darienf 0:832122ce6748 107 char *BytesToHexStr(uint8_t *data, uint32_t length, char *str);
darienf 0:832122ce6748 108 /**
darienf 0:832122ce6748 109 * @brief Parse an incoming string until a CRLF is encountered, dst will contain
darienf 0:832122ce6748 110 * the parsed string
darienf 0:832122ce6748 111 * @param src source string to process
darienf 0:832122ce6748 112 * @param dst destination string to contain the parsed incoming string
darienf 0:832122ce6748 113 * @param length length of incoming src string
darienf 0:832122ce6748 114 * @returns updated pointer in src string
darienf 0:832122ce6748 115 */
darienf 0:832122ce6748 116 char *ParseUntilCRLF(char *src, char *dst, int length);
darienf 0:832122ce6748 117
darienf 0:832122ce6748 118 #endif // _STRINGHELPER_H_