feat: 全量同步 254 个常用的 Arduino 扩展库文件

This commit is contained in:
yczpf2019
2026-01-24 16:05:38 +08:00
parent c665ba662b
commit 397b9a23a3
6878 changed files with 2732224 additions and 1 deletions

View 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;

View 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