Bare metal printf – C standard library without OS

(popovicu.com)

153 points | by todsacerdoti 10 hours ago

11 comments

  • ChuckMcM 9 hours ago
    I was feeling a bit like the Petunia and thought "Oh no, not again." :-) One of the annoyances of embedded programming can be having the wheel re-invented a zillion times. I was pleased to see that the author was just describing good software architecture that creates portable code on top of an environment specific library.

    For doing 'bare metal' embedded work in C you need the crt0 which is the weirdly named C startup code that satisfies the assumption the C compiler made when it compiled your code. And a set of primitives to do what the i/o drivers of an operating system would have been doing for you. And voila, your C program runs on 'bare metal.'

    Another good topic associated with this is setting up hooks to make STDIN and STDOUT work for your particular setup, so that when you type printf() it just automagically works.

    This will also then introduce you to the concept of a basic input/output system or BIOS which exports those primitives. Then you can take that code in flash/eprom and load a binary compilation into memory and start it and now you've got a monitor or a primitive one application at a time OS like CP/M or DOS.

    Its a fun road for students who really want to understand computer systems to go down.

    • LelouBil 8 hours ago
      At my school, we did the following project : https://github.com/lse/k

      It is a small kernel, from only a bootloader to running elf files.

      It has like 10 syscalls if I remember correctly.

      It is very fun, and really makes you understand the ton of legacy support still in modern x86_64 CPUs and what the os underneath is doing with privilege levels and task switching.

      I even implemented a small rom for it that has an interactive ocarina from Ocarina of Time.

      • ChuckMcM 4 hours ago
        This is really neat. So many engineers come out of school without ever having had this sort of 'start to finish' level of hands on experience. If you ever want to do systems or systems analysis this kind of thing will really, really help.
      • pyuser583 6 hours ago
        What is your school? I thought it was the London School of Economics, but it’s another LSE.
    • OnACoffeeBreak 8 hours ago
      No BIOS necessary when we're talking about bare metal systems. printf() will just resolve to a low-level UART-based routine that writes to a FIFO to be played out to the UART when it's not busy. Hell, I've seen systems that forego the FIFO and just write to the UART blocking while writing.
    • dusanh 1 hour ago
      This sounds fascinating and absolutely alien to me, a Python dev. Any good books or other sources to learn more you can recommend?
      • genewitch 8 minutes ago
        There's always the Minix book!
    • marssaxman 9 hours ago
      This was my attempt at a minimal bare-metal C environment:

      https://github.com/marssaxman/startc

      • ChuckMcM 8 hours ago
        That's awesome. Back in the day this was the strong point of eCOS which was a bare metal "platform" for running essentially one application on x86 hardware. The x86 ecosystem has gotten so complicated that being able to do this can get you better performance for an "embedded" app than running on top of Linux or another embedded OS. That translates into your appliance type device using lower cost chips which is a win. When I was playing around with eCos a lot of the digital signage market was using it.
        • guestbest 4 hours ago
          Does anyone still do it that way?
          • ChuckMcM 3 hours ago
            With AMD64 style chips? Probably not. Multi-core systems really need a scheduler to get the most out of them so perhaps there are some very specific applications where that would be a win but I cannot think of anything that isn't super specific. For ARM64 chips with a small number of cores, sure that is still a very viable too for appliance type (application specific) applications.
  • Rochus 5 hours ago
    Newlib is huge and complex (even including old K&R syntax) and adapting the build process to a new system is not trivial. I spent a lot of time with it when I re-targeted chibicc and cparser to EiGen, and finally switched to PDCLib for libc and a part of uClibc for libm; see https://github.com/rochus-keller/EiGen/tree/master/ecc/lib. The result is platform independent besides esentially one file.
  • gitroom 8 minutes ago
    honestly love reading about this stuff - always makes me realize how much gets glossed over in school. you think modern cpus and all the abstraction layers help or just make things messier for folks trying to learn the real basics?
  • rurban 2 hours ago
    220k just to include studio? That's insane. I have 12k and still do IO. Just without the overblown stdio and sbrk, uart_puts is enough. And only in DEBUG mode.
  • Neywiny 8 hours ago
    In school we were taught that the OS does the printf. I think the professors were just trying to generalize to not go on tangents. But, once I learned that no embedded libc variants had printf just no output path, it got a lot easier to figure out how to get it working. I wish I knew about SWO and the magic of semihosting back then. I don't think those would be hard to explain and interestingly it's one of the few things students asked about that in the field I'm also asked how to do by coworkers (the setting up _write).
  • smackeyacky 8 hours ago
    Has anybody played with newlib, but grown the complexity as the system came together?

    It seems like one thing to get a bare-bones printf() working to get you started on a bit of hardware, but as the complexity of the system grows you might want to move on from (say) pushing characters out of a serial interface onto pushing them onto a bitmapped display.

    Does newlib allow you to put different hooks in there as the complexity of the system increases?

    • Gibbon1 7 hours ago
      You can always write a printf replacement that takes a minimal control block that provides put, get, control, and a context.

      That way you can print to a serial port, an LCD Display, or a log.

      Meaning seriously the standard printf is late 1970's hot garbage and no one should use it.

  • saagarjha 7 hours ago

      char buffer[100];
      printf("Type something: ");
      scanf("%s", buffer);
    
    Come on, it’s 2025, there’s no need to write trivial buffer overflows anymore.
    • anyfoo 6 hours ago
      It’s a feature to rewrite your OS kernel on the fly.
    • dbuder 7 hours ago
      It's 1990, maybe 1999, in embedded land.
  • MuffinFlavored 8 hours ago
    I always felt with these kinds of things you strip out `stdio.h` and your new API/ABI/blackbox becomes `syscall` for `write()`, etc.
  • sylware 9 hours ago
    I am coding RISC-V assembly (which I run on x86_64 with a mini-interpreter) but I am careful to avoid the usage of the pseudo-instructions and the registers aliases (no compressed instruction ofc). I have a little tool to generate constant loading code, one-liner (semi-colon separated instructions).

    And as a pre-processor I use a simple C preprocessor (I don't want to tie the code to the pre-processor of a specific assembler): I did that for x86_64 assembly, and I could assemble with gas, nasm and fasmng(fasm2) transparently.

    • 0x000xca0xfe 7 hours ago
      What's wrong with compressed instructions?
  • eqvinox 9 hours ago
    I was very confused by the title, expected someone writing their own printf — i.e. the part that parses the format string, grabs varargs, converts numbers, lines up strings, etc.

    I'd have called it "Bare metal puts()" or "Bare metal write()" or something along those lines instead.

    (FWIW, FreeBSD's printf() is quite easy to pluck out of its surrounding libc infrastructure and adapt/customize.)

    • anyfoo 6 hours ago
      FreeBSD’s printf is my goto, too! It’s indeed enormously simple to pluck out, instantly gives you full-featured printf, and has added features such as dumping memory as hex.
      • eqvinox 4 hours ago
        Funnily enough we're not even referring to the same one, the hexdump thing is in FreeBSD's kernel printf, I was looking at the userspace one :). Haven't looked at the kernel one myself but nice to hear it's also well-engineered.

        (The problem with '%D' hexdumps is that it breaks compiler format checking… and also 'D' is a length modifier for _Decimal64 starting in ISO C23… that's why our hexdump is hooked in as '%.*pHX' instead [which still gives a warning because %p is not supposed to have a precision, but at least it's not entirely broken.])

  • o11c 10 hours ago
    [flagged]
    • alxmdev 9 hours ago
      What's the state of the art for cross-compiling in $CURRENTYEAR?
      • o11c 7 hours ago
        Well, I know it's pretty easy in Debian. (It's not completely pain-free if you need unpackaged third-party libraries and/or if you are cross-compiling from one uncommon architecture to another.)
      • LorenzoGood 9 hours ago
        Honesty probably zig cc.
      • forrestthewoods 9 hours ago
        > What's the state of the art for cross-compiling in $CURRENTYEAR?

        Poopy garbage dog poop.

        glibc is a dumpster fire of bad design. If you want to cross-compile for an arbitrarily old version of glibc then... good luck. It can be done. But it's nightmare fuel.

        • achierius 9 hours ago
          What sort of roadblocks do you run into? Just to get an idea for the flavor of problems.
          • forrestthewoods 9 hours ago
            Well there's two flavors to this. Building glibc and building a program that links against glibc. They're not entirely the same. And you'd think the latter is easier. But you'd be wrong!

            It should be trivial to compile glibc with an arbitrary build system for any target Linux platform from any OS. For example if I'm on Windows and I want to build a program that targets glibc 2.23 for Ubuntu on x86_64 target that should be easy peasy. It is not.

            glibc should have ONE set of .c and .h files for the entire universe. There should be a small number of #define macros that users need to specify to build whatever weird ass flavor they need. These macros should be plainly defined in a single header file that anyone can look at.

            But glibc is a pile of garbage and has generated files for every damn permutation in the universe. This is not necessary. It's a function of bad design. Code should NEVER EVER EVER have a ./configure step that generates files for the local platform. EVER.

            Read this blog post to understand the mountains that Zig moved to enable cross-compilation. It's insane. https://andrewkelley.me/post/zig-cc-powerful-drop-in-replace...

        • zahlman 9 hours ago
          Is the cross-compilation story any better with musl?
        • sylware 9 hours ago
          gcc and glibc SDKs are hell beyond anything sane.

          Like it is done on purpose.

          • forrestthewoods 9 hours ago
            You're getting downvoted but you're not wrong. Well, it's not on purpose per se. It's just really really bad design from the 80s when we didn't know better. And unfortunately its design hasn't been fixed. So we have to deal with almost 40 years of accumulated garbage.
            • doublepg23 9 hours ago
              Aren't there some ideologically driven decisions to make proprietary extensions harder/impossible?