Documentation as Code: A chat with Alasdair Allan from Raspberry Pi

The Electromaker Show · 21 Jul 2022 · 1h 08m

What this episode covers

Alasdair Allan, Head of Documentation at Raspberry Pi, explains the 'Documentation as Code' philosophy used for the RP2040 and Pico W, emphasizing narrative and accessibility. He discusses the challenges of documenting custom ASICs, the pricing strategy behind the $4 Pico, and the importance of bridging the gap between expert engineers and generalist makers. Allan also shares personal project ideas, including a Wi-Fi mesh cannon and a personal time zone clock, while critiquing the friction in modern smart home technology.

Other shows on the same ground, closest first.

  • The Amp Hour · 1h 23m

    Embedded Hardware with the Raspberry Pi Team

    James Adams, Liam Fraser, and Luke Renn from Raspberry Pi Trading discuss the development of the RP2040 microcontroller and the Pico board. They explain the architectural decisions behind the chip, including the use of programmable IO (PIO) state machines, the choice of Cortex-M0+ cores, and the strategic decision to use external flash to maximize SRAM and minimize cost. The conversation also covers the company's flat engineering culture, their low-cost manufacturing strategy, and the integration of the Compute Module 4 (CM4) into industrial applications.

  • The Amp Hour · 1h 03m

    Grumpy Collaboration

    Chris Gammell and Dave Jones discuss the Raspberry Pi Compute Module 4, highlighting the engineering trade-offs of using eMMC flash over SD cards and the significant time penalties for in-situ programming and validation. They critique the commercialization of Raspberry Pi, specifically the move to a .com domain and the opening of a physical store in Cambridge, viewing it as unnecessary marketing 'wankery' for a technical product. The hosts also express skepticism about the recent SPAC merger of Tempo Automation with Advanced Circuits, questioning the $920 million valuation of an assembly house, and dismiss online collaborative design tools like Flux as solving a non-existent problem for hardware engineers who fundamentally work alone.

  • The Amp Hour · 1h 00m

    Documentation Is A Waste Of Time

    Dave Jones and Chris Gammell discuss the critical role of documentation in hardware engineering, contrasting the rigorous requirements of military contractors with the 'get it done' culture of startups where knowledge is often lost when key designers leave. They analyze the Foxconn acquisition of Sharp as a supply chain security move by a giant with excess cash, and review the Raspberry Pi 3's integration of Wi-Fi and Bluetooth into its processor. The conversation concludes with a critique of the 'Coolest Cooler' Kickstarter failure, highlighting how poor unit economics and fulfillment planning can lead to bankruptcy despite massive funding.

  • The Amp Hour · 1h 09m

    The RP1 and beyond with the Raspberry Pi Hardware team

    James Adams (CTO) and Liam Fraser (Hardware/Software Engineer) from Raspberry Pi discuss the development of the RP1 custom silicon, the success of the RP2040 microcontroller, and the architecture of the Raspberry Pi 5. They explain how RP1 acts as a Southbridge/chiplet to offload I/O functions from the main Broadcom SoC, allowing for cost and complexity reductions as process nodes shrink. The conversation covers their internal chip design tooling, sourcing strategies during the chip shortage, and the rationale for sticking with ARM over RISC-V.

  • Embedded.fm · 1h 01m

    128: The American Pi

    Simon Monk, author of over 20 electronics books and founder of Monk Makes, discusses his transition from software engineering to full-time technical writing. He details his workflow for writing books like The Maker's Guide to the Zombie Apocalypse, emphasizing routine, tracking progress via spreadsheets, and building every project to ensure accuracy. Monk also compares the Raspberry Pi and Beagle Bone Black platforms, explaining why the Raspberry Pi has gained dominance in education and hobbyist markets despite the Beagle Bone's initial technical advantages.

The summary, chapters and topics are generated from the episode’s audio by this directory, not written by The Electromaker Show. The episode itself belongs to its publisher.