ORCALINUX(1) User Commands ORCALINUX(1)

orca@linux:~$ man orcalinux

NAME

orcalinux — software engineer, from firmware to the cloud: embedded, Linux, DevOps, security, full-stack. Cairo, Egypt

source: github.com/orcalinux

Hooded engineer seen from behind at three terminals, ORCA LINUX logo on the hoodie

SYNOPSIS

orcalinux idea …

Flags are live: pick one to filter EXAMPLES.

DESCRIPTION

orcalinux works across the whole stack: firmware and bootloaders for ARM Cortex-M, the Linux kernel and drivers, secure protocols, the desktop and web products on top, then containerises, tests and ships them with CI/CD to self-hosted Linux servers. Most work starts at a datasheet and ends in production.

Given an idea, orcalinux tends to ship the whole toolchain around it: a protocol spec, a library, a CLI, a desktop app and a simulator, then writes the course material so others can build it too.

Trained in embedded systems and system programming, including an internship with STMicroelectronics. Cares about the parts nobody sees: a protocol that survives a pulled cable, a page that works in Arabic as well as English, a tool that says exactly what went wrong.

OPTIONS

Linux kernel modules, device drivers and Yocto images for embedded boards.
Bootloaders and reliable firmware updates over UART for ARM Cortex-M.
Bare-metal and FreeRTOS firmware on STM32 / ARM Cortex-M: drivers, interrupts, TFT displays, GPS, plus CAN, LIN and AUTOSAR, AVR and Infineon AURIX.
Linux system programming in C: syscalls, namespaces, allocators, reusable libraries.
Machines from first principles: a CHIP-8 emulator, a 6502 emulator, Verilog CPU parts.
Desktop and web products: Qt / QML and PySide6 tools, command-line tools, full-stack TypeScript / Next.js apps on PostgreSQL with Arabic and English right-to-left layouts, and a TINY-language compiler.
Framed, checked and retried links between machines (SLIP, CRC, UART), parsers, and end-to-end encryption: X3DH, Double Ratchet and MLS in C++ and Rust, with WebAssembly builds.
Docker and Compose environments, GitHub Actions CI/CD with tests, coverage, fuzzing, CodeQL and tagged releases, systemd services on self-hosted Linux servers, automated backups and Debian packaging.

EXAMPLES

$ orcalinux --all # 10 of 10 examples

$git clone https://github.com/orcalinux/bootwire

bootwire

Reliable firmware updates for ARM Cortex-M over UART: a stop-and-wait protocol with CRC-checked SLIP frames, a full spec, a Python library, a CLI with a man page, a Debian package, a simulated target and a desktop app with a live frame inspector. 148 tests, including fault injection, on Linux and Windows CI.

Pythoncortex-m · stm32 · uart · pyside6 · qt-quick

$git clone https://github.com/orcalinux/system-programming-under-linux

system-programming-under-linux

System programming internship at STMicroelectronics: syscalls, namespaces, a heap memory allocator, routing, QEMU, Docker / Podman, systemd-nspawn and Yocto.

C★ 7linux-syscall · namespaces · qemu · yocto

$git clone https://github.com/orcalinux/embedded-linux-diploma

embedded-linux-diploma

Linux kernel development, Yocto customization, Raspberry Pi, modern C++ and device-driver creation for embedded systems.

C++★ 9yocto · linux-fundamentals · modern-cpp

$git clone https://github.com/orcalinux/GPS-Distance-Tracking-System

GPS-Distance-Tracking-System

Embedded GPS distance tracker on ARM, written in C and assembly, built with CMake and Make.

C★ 13arm · gps · embedded-c · assembly

$git clone https://github.com/orcalinux/linux-memory-manager

linux-memory-manager

A heap memory manager for Linux: a custom low-fragmentation allocator, thread-safe intrusive lists, Doxygen docs and tests.

Callocator · memory-management · linux

$git clone https://github.com/orcalinux/chip8-emulator

chip8-emulator

CHIP-8 emulator in C with SDL2 graphics and input. Runs classic 1970s CHIP-8 games with configurable window size and colours.

C★ 3emulator · sdl2 · low-level

$git clone https://github.com/orcalinux/c-json

c-json

Lightweight, cross-platform JSON parsing library for C: objects, arrays, strings, numbers, booleans and null with minimal memory overhead.

C★ 2json-parser · scanner · parsing

$git clone https://github.com/orcalinux/object-pool-library

object-pool-library

Thread-safe pool of reusable objects in C, with dynamic resizing and a small API for init, object management and teardown.

Cmemory-management · multithreading · thread-safe

$git clone https://github.com/orcalinux/tiny-language-compiler

tiny-language-compiler

Compiler for the TINY teaching language: lexical analysis, parsing and a GUI to inspect each stage.

C++compiler-design · parser · scanner

$git clone https://github.com/orcalinux/youtube-downloader

youtube-downloader

Command-line downloader for single videos or whole playlists, with a Rich interface, concurrent downloads and clean Ctrl+C handling. Ships with a Dockerfile and Makefile.

Python★ 1cli · docker · makefile

FILES

~/courses/imt-arm-cortex/ ★ 21
ARM embedded systems and IoT course: interrupts, real-time processing, communication protocols, TFT displays, Wi-Fi modules, bootloader.
~/courses/arm-cortex-workshop/ ★ 13
Workshop from C basics to ARM architecture, peripherals, interrupts and FreeRTOS on the STM32F103.
~/courses/computer-organization/ ★ 3
Verilog examples and material: 8086, a programmable interrupt controller, synthesis.
~/courses/automotive-autosar/ ★ 2
Automotive communication protocols and an introduction to AUTOSAR.
~/courses/avr-crash-course/
A crash course on AVR microcontrollers.
~/projects/autonomous-car/
STM32F103 car with ultrasonic sensors, GPS and FreeRTOS, avoiding obstacles and reporting live status.

SEE ALSO

bootwire(1), tiny-language-compiler(1), c-json(3), object-pool-library(3), linux-memory-manager(3), chip8-emulator(6), orcalinux(7)

BUGS

Prefers printf debugging to slides. Found something wrong in a repository? Open an issue on that repository.

AUTHOR

Written by orcalinux, Cairo, Egypt.

$ open github.com/orcalinux

Manual page orcalinux(1) line 1/1 (0%) (press h for help or q to quit)

SUMMARY OF LESS COMMANDS

j k
Forward / backward a few lines.
d u
Forward / backward half a window.
g G
Go to first / last line.
/pattern
Search for pattern.
n N
Next / previous match.
1–8
Toggle a flag: kernel, bootloader, mcu, sysprog, emu, tools, protocols, devops.
t or `
Open the terminal (try help, neofetch, ls projects).
h q Esc
Show / close this help.