feat: 全量同步 254 个常用的 Arduino 扩展库文件
This commit is contained in:
262
arduino-libs/arduino-cli/libraries/rBASE64/src/rBase64.cpp
Normal file
262
arduino-libs/arduino-cli/libraries/rBASE64/src/rBase64.cpp
Normal file
@@ -0,0 +1,262 @@
|
||||
// ---------------------------------------------------------------------------
|
||||
// Created by Abhijit Bose (boseji) on 22/02/16.
|
||||
// Copyright 2016 - Under creative commons license 3.0:
|
||||
// Attribution-ShareAlike CC BY-SA
|
||||
//
|
||||
// This software is furnished "as is", without technical support, and with no
|
||||
// warranty, express or implied, as to its usefulness for any purpose.
|
||||
//
|
||||
// Thread Safe: No
|
||||
// Extendable: Yes
|
||||
//
|
||||
// @file rBase64.cpp
|
||||
//
|
||||
// @brief
|
||||
// Library to provide the BASE64 conversion and vis-versa
|
||||
//
|
||||
// @version API 1.0.0
|
||||
//
|
||||
//
|
||||
// @author boseji - salearj@hotmail.com
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
#include "Arduino.h"
|
||||
#include "rBase64.h"
|
||||
|
||||
const char b64_alphabet[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
|
||||
"abcdefghijklmnopqrstuvwxyz"
|
||||
"0123456789+/";
|
||||
|
||||
// Internal Buffer
|
||||
char buf[128];
|
||||
/* 'Private' declarations */
|
||||
inline void a3_to_a4(unsigned char * a4, unsigned char * a3);
|
||||
inline void a4_to_a3(unsigned char * a3, unsigned char * a4);
|
||||
inline unsigned char b64_lookup(char c);
|
||||
|
||||
size_t rbase64_encode(char *output, char *input, size_t inputLen) {
|
||||
int i = 0, j = 0;
|
||||
size_t encLen = 0;
|
||||
unsigned char a3[3];
|
||||
unsigned char a4[4];
|
||||
|
||||
while(inputLen--) {
|
||||
a3[i++] = *(input++);
|
||||
if(i == 3) {
|
||||
a3_to_a4(a4, a3);
|
||||
|
||||
for(i = 0; i < 4; i++) {
|
||||
output[encLen++] = b64_alphabet[a4[i]];
|
||||
}
|
||||
|
||||
i = 0;
|
||||
}
|
||||
}
|
||||
|
||||
if(i) {
|
||||
for(j = i; j < 3; j++) {
|
||||
a3[j] = '\0';
|
||||
}
|
||||
|
||||
a3_to_a4(a4, a3);
|
||||
|
||||
for(j = 0; j < i + 1; j++) {
|
||||
output[encLen++] = b64_alphabet[a4[j]];
|
||||
}
|
||||
|
||||
while((i++ < 3)) {
|
||||
output[encLen++] = '=';
|
||||
}
|
||||
}
|
||||
output[encLen] = '\0';
|
||||
return encLen;
|
||||
}
|
||||
|
||||
size_t rbase64_decode(char * output, char * input, size_t inputLen) {
|
||||
int i = 0, j = 0;
|
||||
size_t decLen = 0;
|
||||
unsigned char a3[3];
|
||||
unsigned char a4[4];
|
||||
|
||||
|
||||
while (inputLen--) {
|
||||
if(*input == '=') {
|
||||
break;
|
||||
}
|
||||
|
||||
a4[i++] = *(input++);
|
||||
if (i == 4) {
|
||||
for (i = 0; i <4; i++) {
|
||||
a4[i] = b64_lookup(a4[i]);
|
||||
}
|
||||
|
||||
a4_to_a3(a3,a4);
|
||||
|
||||
for (i = 0; i < 3; i++) {
|
||||
output[decLen++] = a3[i];
|
||||
}
|
||||
i = 0;
|
||||
}
|
||||
}
|
||||
|
||||
if (i) {
|
||||
for (j = i; j < 4; j++) {
|
||||
a4[j] = '\0';
|
||||
}
|
||||
|
||||
for (j = 0; j <4; j++) {
|
||||
a4[j] = b64_lookup(a4[j]);
|
||||
}
|
||||
|
||||
a4_to_a3(a3,a4);
|
||||
|
||||
for (j = 0; j < i - 1; j++) {
|
||||
output[decLen++] = a3[j];
|
||||
}
|
||||
}
|
||||
output[decLen] = '\0';
|
||||
return decLen;
|
||||
}
|
||||
|
||||
size_t rbase64_enc_len(size_t plainLen) {
|
||||
size_t n = plainLen;
|
||||
return (n + 2 - ((n + 2) % 3)) / 3 * 4;
|
||||
}
|
||||
|
||||
size_t rbase64_dec_len(char * input, size_t inputLen) {
|
||||
uint32_t i = 0;
|
||||
size_t numEq = 0;
|
||||
for(i = inputLen - 1; input[i] == '='; i--) {
|
||||
numEq++;
|
||||
}
|
||||
|
||||
return (size_t)(((6 * inputLen) / 8) - numEq);
|
||||
}
|
||||
|
||||
inline void a3_to_a4(unsigned char * a4, unsigned char * a3) {
|
||||
a4[0] = (a3[0] & 0xfc) >> 2;
|
||||
a4[1] = ((a3[0] & 0x03) << 4) + ((a3[1] & 0xf0) >> 4);
|
||||
a4[2] = ((a3[1] & 0x0f) << 2) + ((a3[2] & 0xc0) >> 6);
|
||||
a4[3] = (a3[2] & 0x3f);
|
||||
}
|
||||
|
||||
inline void a4_to_a3(unsigned char * a3, unsigned char * a4) {
|
||||
a3[0] = (a4[0] << 2) + ((a4[1] & 0x30) >> 4);
|
||||
a3[1] = ((a4[1] & 0xf) << 4) + ((a4[2] & 0x3c) >> 2);
|
||||
a3[2] = ((a4[2] & 0x3) << 6) + a4[3];
|
||||
}
|
||||
|
||||
inline unsigned char b64_lookup(char c) {
|
||||
int i;
|
||||
for(i = 0; i < 64; i++) {
|
||||
if(b64_alphabet[i] == c) {
|
||||
return i;
|
||||
}
|
||||
}
|
||||
|
||||
return -1;
|
||||
}
|
||||
|
||||
/**
|
||||
* Function to Encode the Byte Array to a BASE64 encoded String
|
||||
*
|
||||
* @param data Pointer to the Source Buffer
|
||||
* @param length Source Buffer Length
|
||||
*
|
||||
* @return Encoded String else the '-FAIL-' string in case of Error
|
||||
*/
|
||||
String rBASE64::encode(uint8_t *data, size_t length)
|
||||
{
|
||||
size_t o_length = rbase64_enc_len(length);
|
||||
String s = "-FAIL-";
|
||||
// Check Size
|
||||
if(o_length < 128)
|
||||
{
|
||||
s.reserve(o_length);
|
||||
|
||||
/* Make sure that the Length is Ok for the Output */
|
||||
if(o_length == rbase64_encode(buf,(char *)data,length))
|
||||
{
|
||||
s = String(buf);
|
||||
}
|
||||
}
|
||||
return s;
|
||||
}
|
||||
|
||||
/**
|
||||
* Function to Encode the Byte Array to a BASE64 encoded String
|
||||
*
|
||||
* @param data Pointer to the Source Buffer
|
||||
* @waring This function assumes that the Input String is a NULL terminated buffer
|
||||
*
|
||||
* @return Encoded String else the '-FAIL-' string in case of Error
|
||||
*/
|
||||
String rBASE64::encode(char *data)
|
||||
{
|
||||
return rBASE64::encode((uint8_t *)data, strlen(data));
|
||||
}
|
||||
|
||||
/**
|
||||
* Function to Encode the Byte Array to a BASE64 encoded String
|
||||
*
|
||||
* @param text String containing the Source Buffer
|
||||
*
|
||||
* @return Encoded String else the '-FAIL-' string in case of Error
|
||||
*/
|
||||
String rBASE64::encode(String text)
|
||||
{
|
||||
return rBASE64::encode((uint8_t *) text.c_str(), text.length());
|
||||
}
|
||||
|
||||
/**
|
||||
* Function to Decode the Byte Array with BASE64 encoded String to Normal String
|
||||
*
|
||||
* @param data Pointer to the Source Buffer
|
||||
* @param length Source Buffer Length
|
||||
*
|
||||
* @return Decoded String else the '-FAIL-' string in case of Error
|
||||
*/
|
||||
String rBASE64::decode(uint8_t *data, size_t length)
|
||||
{
|
||||
size_t o_length = rbase64_dec_len((char *)data, length);
|
||||
String s = "-FAIL-";
|
||||
|
||||
// Check Size
|
||||
if(o_length < 128)
|
||||
{
|
||||
/* Make sure that the Length is Ok for the Output */
|
||||
if(o_length == rbase64_decode(buf,(char *)data,length))
|
||||
{
|
||||
s = String(buf);
|
||||
}
|
||||
}
|
||||
return s;
|
||||
}
|
||||
|
||||
/**
|
||||
* Function to Decode the Byte Array with BASE64 encoded String to Normal String
|
||||
*
|
||||
* @param data Pointer to the Source Buffer
|
||||
* @waring This function assumes that the Input String is a NULL terminated buffer
|
||||
*
|
||||
* @return Decoded String else the '-FAIL-' string in case of Error
|
||||
*/
|
||||
String rBASE64::decode(char *data)
|
||||
{
|
||||
return rBASE64::decode((uint8_t *)data, strlen(data));
|
||||
}
|
||||
|
||||
/**
|
||||
* Function to Decode the Byte Array with BASE64 encoded String to Normal String
|
||||
*
|
||||
* @param text String containing the Source Buffer
|
||||
*
|
||||
* @return Decoded String else the '-FAIL-' string in case of Error
|
||||
*/
|
||||
String rBASE64::decode(String text)
|
||||
{
|
||||
return rBASE64::decode((uint8_t *) text.c_str(), text.length());
|
||||
}
|
||||
|
||||
/* Declaring the Main Class Instance */
|
||||
rBASE64 rbase64;
|
||||
116
arduino-libs/arduino-cli/libraries/rBASE64/src/rBase64.h
Normal file
116
arduino-libs/arduino-cli/libraries/rBASE64/src/rBase64.h
Normal file
@@ -0,0 +1,116 @@
|
||||
// ---------------------------------------------------------------------------
|
||||
// Created by Abhijit Bose (boseji) on 22/02/16.
|
||||
// Copyright 2016 - Under creative commons license 3.0:
|
||||
// Attribution-ShareAlike CC BY-SA
|
||||
//
|
||||
// This software is furnished "as is", without technical support, and with no
|
||||
// warranty, express or implied, as to its usefulness for any purpose.
|
||||
//
|
||||
// Thread Safe: No
|
||||
// Extendable: Yes
|
||||
//
|
||||
// @file rBase64.h
|
||||
//
|
||||
// @brief
|
||||
// Library to provide the BASE64 conversion and vis-versa
|
||||
//
|
||||
// @attribution
|
||||
// This is based on the prior work done by Markus Sattler for ESP8266 BASE64
|
||||
// implementation and Per Ejeklint for ArduinoWebsocketServer project
|
||||
//
|
||||
// @version API 1.0.0
|
||||
//
|
||||
//
|
||||
// @author boseji - salearj@hotmail.com
|
||||
// ---------------------------------------------------------------------------
|
||||
|
||||
#ifndef _RBASE64_H
|
||||
#define _RBASE64_H
|
||||
|
||||
/* b64_alphabet:
|
||||
* Description: Base64 alphabet table, a mapping between integers
|
||||
* and base64 digits
|
||||
* Notes: This is an extern here but is defined in Base64.c
|
||||
*/
|
||||
extern const char b64_alphabet[];
|
||||
|
||||
/* base64_encode:
|
||||
* Description:
|
||||
* Encode a string of characters as base64
|
||||
* Parameters:
|
||||
* output: the output buffer for the encoding, stores the encoded string
|
||||
* input: the input buffer for the encoding, stores the binary to be encoded
|
||||
* inputLen: the length of the input buffer, in bytes
|
||||
* Return value:
|
||||
* Returns the length of the encoded string
|
||||
* Requirements:
|
||||
* 1. output must not be null or empty
|
||||
* 2. input must not be null
|
||||
* 3. inputLen must be greater than or equal to 0
|
||||
*/
|
||||
size_t rbase64_encode(char *output, char *input, size_t inputLen);
|
||||
|
||||
/* base64_decode:
|
||||
* Description:
|
||||
* Decode a base64 encoded string into bytes
|
||||
* Parameters:
|
||||
* output: the output buffer for the decoding,
|
||||
* stores the decoded binary
|
||||
* input: the input buffer for the decoding,
|
||||
* stores the base64 string to be decoded
|
||||
* inputLen: the length of the input buffer, in bytes
|
||||
* Return value:
|
||||
* Returns the length of the decoded string
|
||||
* Requirements:
|
||||
* 1. output must not be null or empty
|
||||
* 2. input must not be null
|
||||
* 3. inputLen must be greater than or equal to 0
|
||||
*/
|
||||
size_t rbase64_decode(char *output, char *input, size_t inputLen);
|
||||
|
||||
/* base64_enc_len:
|
||||
* Description:
|
||||
* Returns the length of a base64 encoded string whose decoded
|
||||
* form is inputLen bytes long
|
||||
* Parameters:
|
||||
* inputLen: the length of the decoded string
|
||||
* Return value:
|
||||
* The length of a base64 encoded string whose decoded form
|
||||
* is inputLen bytes long
|
||||
* Requirements:
|
||||
* None
|
||||
*/
|
||||
size_t rbase64_enc_len(size_t inputLen);
|
||||
|
||||
/* base64_dec_len:
|
||||
* Description:
|
||||
* Returns the length of the decoded form of a
|
||||
* base64 encoded string
|
||||
* Parameters:
|
||||
* input: the base64 encoded string to be measured
|
||||
* inputLen: the length of the base64 encoded string
|
||||
* Return value:
|
||||
* Returns the length of the decoded form of a
|
||||
* base64 encoded string
|
||||
* Requirements:
|
||||
* 1. input must not be null
|
||||
* 2. input must be greater than or equal to zero
|
||||
*/
|
||||
size_t rbase64_dec_len(char *input, size_t inputLen);
|
||||
|
||||
/*
|
||||
Base 64 Class for Implementing the bidirectional transactions on BASE64
|
||||
*/
|
||||
class rBASE64 {
|
||||
public:
|
||||
String encode(uint8_t *data, size_t length);
|
||||
String encode(char *data);
|
||||
String encode(String text);
|
||||
String decode(uint8_t *data, size_t length);
|
||||
String decode(char *data);
|
||||
String decode(String text);
|
||||
};
|
||||
|
||||
extern rBASE64 rbase64;
|
||||
|
||||
#endif // _RBASE64_H
|
||||
Reference in New Issue
Block a user