FreeScript
circle
by rsta2 · version 2026.11.14 · updated 2 days ago
No reviews yet
- Downloads
- 0
- Reviews
- 0
- Size
- 4 MB
- Code check
- Checked
- Licence
- GPL-3.0
- Released
- Nov 2026
A C++ bare metal environment for Raspberry Pi with USB (32 and 64 bit)
Circle
======
Overview
Circle is a C++ bare metal programming environment for the Raspberry Pi. It should be usable on most existing models (see "Support Status" below). Circle provides several ready-tested C++ classes and add-on libraries, which can be used to control different hardware features of the Raspberry Pi. Together with Circle there are delivered several sample programs, which demonstrate the use of its classes. Circle can be used to create 32-bit or 64-bit bare metal applications.
Circle includes bigger (optional) third-party C-libraries for specific purposes in addon/ now. This is the reason why GitHub rates the project as a C-language-project. The main Circle libraries are written in C++ using classes instead. That's why it is called a C++ programming environment.
Disclaimer
Circle is a free open-source project created by makers for makers. Because it targets bare-metal systems and is developed without formal QA or access to every hardware variant, it may not work as expected in all environments.
This hotfix release reverts a commit, which does not allow to use lld as the linker with Clang, which is planned to be used with circle-stdlib. Furthermore it comes with an additional sanity check for the 8BitDo gamepad drivers.
Release 51.1
This release comes with support for the Official 5" and 7" Touchscreens (v1 and v2) with DSI interface on the Raspberry Pi 5 in addon/rp1dsi/. This can be tested with sample/28-touchscreen and addon/lvgl/sample. You have to set the
Another attempt to overcome the dropped USB MIDI events problem on the Raspberry Pi 1-3 and Zero has been made. The cmdline.txt option
If you are using USB in FIQ mode on the Raspberry Pi 1-3 and Zero with the system option
More news:
This release offers a significantly improved implementation of the TCP/IP network stack. It supports TCP congestion control according to RFC 5681 with Fast Retransmit and Fast Recovery. Also the unnecessary copying of frames and data in the stack is largely prevented. This improves throughput very much, especially when a Raspberry Pi with 100 MBps Ethernet is connected to a Gigabit network.
The socket API is nearly unchanged, but the new
Circle supports the extended C++ standard librar
…
======
Overview
Circle is a C++ bare metal programming environment for the Raspberry Pi. It should be usable on most existing models (see "Support Status" below). Circle provides several ready-tested C++ classes and add-on libraries, which can be used to control different hardware features of the Raspberry Pi. Together with Circle there are delivered several sample programs, which demonstrate the use of its classes. Circle can be used to create 32-bit or 64-bit bare metal applications.
Circle includes bigger (optional) third-party C-libraries for specific purposes in addon/ now. This is the reason why GitHub rates the project as a C-language-project. The main Circle libraries are written in C++ using classes instead. That's why it is called a C++ programming environment.
Disclaimer
Circle is a free open-source project created by makers for makers. Because it targets bare-metal systems and is developed without formal QA or access to every hardware variant, it may not work as expected in all environments.
- No warranty: Circle is provided "as is" without any express or implied warranties, including merchantability, fitness for a particular purpose, or noninfringement.
- Limited testing: Contributors and maintainers test to the best of their ability but do not operate a dedicated testing department and cannot validate Circle on every device, bootloader version, or model revision.
- User responsibility: If you integrate Circle into a project - especially a commercial product (not recommended) - you are responsible for thoroughly testing the software in your target environment and for any consequences of its use.
- Source-only distribution: We publish Circle only as source code; no official binary releases are provided.
- Risk acknowledgement: By using Circle you acknowledge the residual risks associated with bare-metal development and accept responsibility for verifying suitability and safety for your use case.
This hotfix release reverts a commit, which does not allow to use lld as the linker with Clang, which is planned to be used with circle-stdlib. Furthermore it comes with an additional sanity check for the 8BitDo gamepad drivers.
Release 51.1
This release comes with support for the Official 5" and 7" Touchscreens (v1 and v2) with DSI interface on the Raspberry Pi 5 in addon/rp1dsi/. This can be tested with sample/28-touchscreen and addon/lvgl/sample. You have to set the
DSI_DISPLAY variable in the respective Makefile to use the DSI displays.Another attempt to overcome the dropped USB MIDI events problem on the Raspberry Pi 1-3 and Zero has been made. The cmdline.txt option
usbboost= has been extended and gets a bit-masked decimal parameter now, where each bit 0-3 enables an option, which can help to fix such problems. See the doc/cmdline.txt for a detailed description. usbboost=15 enables all options, but does work only, when the USB MIDI controller is directly connected to the USB root port (without hub).If you are using USB in FIQ mode on the Raspberry Pi 1-3 and Zero with the system option
USE_USB_FIQ, you can try to enable the option USB_MIDI_FIQ_COMPLETION too to reduce the latency on delivering received MIDI events to the minimum. Your MIDI event packet handler must be able to run on FIQ_LEVEL in this case. Normally it runs on IRQ_LEVEL. Additionally you can define USB_MIDI_CHECK_INCOMING to validate incoming MIDI event packets, before calling the MIDI event packet handler.More news:
- A new log severity
LogTracefor frequent trace messages is introduced. Messages with this severity can be generated with the macroLOGTRACE(). Log messages of this kind are only displayed, when the optionloglevel=5is specified in the file cmdline.txt on the SD card. - A number of 8BitDo Xbox360 gamepads and keyboards is supported now.
- Support for USB mice with generic HID interface (3-0-0) has been added.
- FatFs has been updated to R0.16 with patch 2.
- An invalid handling of TCP ACK for fragmented modem sessions has been corrected. This also solved the issue of sending scrambled TCP data over low-speed/-quality network links.
- A race condition in
CSynchronizationEvent::Wait()has been fixed, which could cause lost wake events, when this method had been called from an IRQ handler. - A spurious hang caused by unexpected USB Disconnect events on cold boot has been fixed.
- Hidden WLAN SSIDs are supported now. You have to add the
scan_ssid=1option for the hidden SSID to the file wpa_supplicant.conf. - USB mass-storage gadget has speed auto-negotiation and a robust host reset/suspend handling now.
- Fixed that WLAN was unable to connect to eero7 router.
This release offers a significantly improved implementation of the TCP/IP network stack. It supports TCP congestion control according to RFC 5681 with Fast Retransmit and Fast Recovery. Also the unnecessary copying of frames and data in the stack is largely prevented. This improves throughput very much, especially when a Raspberry Pi with 100 MBps Ethernet is connected to a Gigabit network.
The socket API is nearly unchanged, but the new
MSG_MORE flag can be specified, when calling CSocket::Send() on TCP sockets, which prevents the immediate delivery of received data on the receiver side, when more data follows. CSocket::Bind() can be called with port 0 to bind to an ephemeral port, which can be requested using CSocket::GetOwnPort(). CSocket::SendTo() without preceding Bind() or Connect() is allowed too, which automatically assigns an ephemeral port.Circle supports the extended C++ standard librar
…