Pt 101422

Bill G., the author of the fantastic SDfat library that Arduino uses to talk to SD cards passed along this document detailing a list of rules that military embedded programmers follow when designing embedded C++. This is handy brush up for all of us who write embedded code (PDF).

The intent of this document is to provide direction and guidance to C++ programmers that will enable them to employ good programming style and proven programming practices leading to safe, reliable, testable, and maintainable code. Consequently, the rules contained in this document are required for Air Vehicle C++ development1 and recommended for non-Air Vehicle C++ development.

As indicated above, portions of Air Vehicle (AV) code will be developed in C++. C++ was designed to support data abstraction, object-oriented programming, and generic programming while retaining compatibility with traditional C programming techniques.

Adafruit publishes a wide range of writing and video content, including interviews and reporting on the maker market and the wider technology world. Our standards page is intended as a guide to best practices that Adafruit uses, as well as an outline of the ethical standards Adafruit aspires to. While Adafruit is not an independent journalistic institution, Adafruit strives to be a fair, informative, and positive voice within the community – check it out here:

Join Adafruit on Mastodon

Adafruit is on Mastodon, join in!

Stop breadboarding and soldering – start making immediately! Adafruit’s Circuit Playground is jam-packed with LEDs, sensors, buttons, alligator clip pads and more. Build projects with Circuit Playground in a few minutes with the drag-and-drop MakeCode programming site, learn computer science using the CS Discoveries class on, jump into CircuitPython to learn Python and hardware together, TinyGO, or even use the Arduino IDE. Circuit Playground Express is the newest and best Circuit Playground board, with support for CircuitPython, MakeCode, and Arduino. It has a powerful processor, 10 NeoPixels, mini speaker, InfraRed receive and transmit, two buttons, a switch, 14 alligator clip pads, and lots of sensors: capacitive touch, IR proximity, temperature, light, motion and sound. A whole wide world of electronics and coding is waiting for you, and it fits in the palm of your hand.

Have an amazing project to share? The Electronics Show and Tell is every Wednesday at 7pm ET! To join, head over to YouTube and check out the show’s live chat – we’ll post the link there.

Join us every Wednesday night at 8pm ET for Ask an Engineer!

Join over 36,000+ makers on Adafruit’s Discord channels and be part of the community!

CircuitPython – The easiest way to program microcontrollers –

Maker Business — “Packaging” chips in the US

Wearables — Enclosures help fight body humidity in costumes

Electronics — Transformers: More than meets the eye!

Python for Microcontrollers — Python on Microcontrollers Newsletter: Silicon Labs introduces CircuitPython support, and more! #CircuitPython #Python #micropython @ThePSF @Raspberry_Pi

Adafruit IoT Monthly — Guardian Robot, Weather-wise Umbrella Stand, and more!

Microsoft MakeCode — MakeCode Thank You!

EYE on NPI — Maxim’s Himalaya uSLIC Step-Down Power Module #EyeOnNPI @maximintegrated @digikey

New Products – Adafruit Industries – Makers, hackers, artists, designers and engineers! — #NewProds 7/19/23 Feat. Adafruit Matrix Portal S3 CircuitPython Powered Internet Display!

Get the only spam-free daily newsletter about wearables, running a "maker business", electronic tips and more! Subscribe at !


  1. Kevin Townsend

    Great find! While languages like C# have fairly widely accepted ‘standards’ that most professional developers seem to follow, C and C++ tend to be all over the place for things like naming conventions, etc. There’s a lot of wisdom in the document referenced above. Definately have to print a copy out and slap some notes in the margins.

  2. Kevin Townsend

    Oh … can I recommend the guide to writing unmaintainable code?

    Naming Rule #18: Bedazzling Names

    Choose variable names with irrelevant emotional connotation, e. g.:
    marypoppins = ( superman + starship ) / god;

    This confuses the reader because they have difficulty disassociating the emotional connotations of the words from the logic they’re trying to think about.

  3. amazing

  4. Richard Perrin

    If you don’t write embedded C++ code in a critical environment, I’d urge you to walk away from this and read a general software style guide like "The Practice of Programming" or "The Pragmatic Programmer" or "Code Complete". Or the "Effective C++" books, or any of the other C++ guides that encourage you to master a subsection of the language.

    This is 146 pages of specification constraining how C++ should be used when developing software for military aircraft embedded systems. It ain’t fun. It is full of hard-won lessons about how not to shoot yourself in the foot (or more appropriately for the language: how not to blow your whole leg off) when writing large embedded C++ modules and projects in large teams. This can be a joyless experience, and in fact I’m sure many embedded developers had a joyless experience working on the JSF project. I know at least one that found it so.

    If you are looking for guidelines on better embedded C++, skim this, use your common sense, but don’t let it cramp your style.

Sorry, the comment form is closed at this time.