History

Earle F. Philhower, III f6973fc64d Add RISC-V support, GCC 14 move (#2491 ) * Adds RISC-V compilation option to the IDE and Platform.IO. * Build RP2350-RISCV libpico, libbearssl * Fix RP2350 BearSSL library (was copied from RP2040, now built for M33) * New GCC 14.2 toolchain is required (12.4 RISC-V support is borked) * Newlib locking fixed prototypes * Manually force all runtime init code into RP2350 binaries * Add RISC-V to CI * Remove RP2350 BOOT2.S files, binaries (not used) * Clean up minor GCC 14.x warnings * Add RP2350-RISCV OTA build, link * Add RISC-V FreeRTOS files (configuration still not running, but builds) * Add basic documentation		2024-09-29 15:10:36 -07:00
..
bearssl@c2c9d9d08f	Migrate to 2.0.0 SDK (#2336 )	2024-08-17 10:39:13 -07:00
Makefile	Add RISC-V support, GCC 14 move (#2491 )	2024-09-29 15:10:36 -07:00
README.md	Add WiFiClientSecure and WifiServerSecure (TLS) support, NTP (#683 )	2022-07-18 20:24:11 -07:00

README.md

BearSSL ESP8266 builder

This directory contains the git submodule for the ESP8266 ported bearssl low-level library, a port of BearSSL

If you are only working on the BearSSL:: namespace functions in the Arduino ESP8266WiFi library (BearSSL::WiFiClientSecure, BearSSL::WiFiServerSecure, etc.) you do NOT need to work in this directory.

Normal users can simply use the libbearssl.a file already included in the Arduino repo. Experienced users looking to work on the underlying BearSSL-ESP8266 ported library can use this directory to automate the build flow.

Prerequisites

The tools directory needs to be populated (i.e. Arduino IDE should be able to compile an executable probect. get.py should ensure this).

UNIX-like system (Linux, Mac):

If you need to change the *.t0 (Forth-like language) you will need a .NET-compatible runtime (such as mono under Linux) to rebuild the resulant .c files.

For Windows (untested)

Microsoft's .NET runtime must be installed to run the .t0->.c workflow.

Building

make all: Init the submodule, if needed, then build but do not install the library
make install: Init the submodule, if needed, then build and copy the library to the standard location in tools/sdk/lib

Editing the library

https://github.com/earlephilhower/bearssl-esp8266 is the current repository for this library. A git remote to the original BearSSL sources from https://bearssl.org/git/BearSSL is added on submodule init. You can either manually do pulls, or make merge-upstream to bring in any BearSSL upstream changes.

Documentation in the library README-esp8266 and git log describes the changes done.

Feel free to drop me a line at earlephilhower@yahoo.com if you have questions.

-Earle F. Philhower, III