Specs & Technical Documents

A technical reference shelf for architecture, protocol behavior, embedded systems, networking, firmware and production engineering. These documents explain constraints and system behavior; project delivery and case studies remain under Work.

Engineering Notes · 2 min read · 2023-04-04

Variable Names Preserve the Meaning of State

Knowing that a variable contains a number is not the same as knowing what the number means. A name that preserves unit, time, or state reduces the amount of context a future reader has to reconstruct.

Telecom & VoIP · 2 min read · 2025-01-27

DTMF: The Sound of a Button and the Event of a Button

Pressing a phone key is meant to trigger an action: enter a menu, select an option, or confirm information. In a phone system, however, that action may travel as an audible tone or as a separate media event. To the user it is the same button; to the system they are different paths.

Telecom & VoIP · 2 min read · 2024-01-20

SIP Registration Is an Address, Not Complete Proof of Liveness

SIP registration records a relationship between an identity and a reachable contact address. That address being present does not prove the phone is fully usable at this moment. Registration is a memory of recent state, and expiry defines how long that memory is trusted.

Telecom & VoIP · 2 min read · 2023-12-25

An RTP Timestamp Is Not Wall-Clock Time

A timestamp inside a packet can look like a clock reading, but RTP timestamps primarily describe position in the media clock. Wall-clock time, media time, and packet arrival time are different concepts.

Telecom & VoIP · 2 min read · 2022-10-28

A Connected Call and Delivered Audio Are Different Events

When the call timer starts, we tend to assume communication has succeeded. But SIP can establish the signaling state while the path that carries audio is still broken. Who is talking to whom and how the media packets reach them are not answered by the same process.

Telecom & VoIP · 2 min read · 2022-01-13

Changing Codecs Changes the Work Behind the Audio

If a codec is treated as nothing more than an audio format, a large part of the cost inside a phone system stays hidden. When two sides cannot use the same codec, audio may need to be decoded and encoded again in the middle.

Embedded & Firmware · 2 min read · 2024-10-30

What Happens if Power Fails While Writing Flash?

It is easy to think of saving data as one indivisible event: write it and it is done. In reality, power can disappear in the middle of a write. The next boot then has to distinguish complete, incomplete, and usable state.

Production Engineering · 2 min read · 2025-04-13

Container Count Is Not a Memory Budget

Counting containers does not tell you how much pressure a server is under. One container may do very little while another holds data, caches, and many threads. Two servers with the same container count can have very different resource needs.

Production Engineering · 2 min read · 2024-02-17

Reuse Is an Engineering Decision Too

Building from scratch is a great way to learn, but existing software may solve a user's problem faster and more reliably. Reuse does not remove engineering judgment; it changes what must be evaluated.

Firmware Release Engineering · 2 min read · 2024-12-07

Firmware Has a Version; Configuration Needs One Too

A device can receive new firmware while keeping old configuration. If new code reads that stored data with a different meaning, behavior can change after the update. Two devices on the same firmware may then behave differently because their stored history differs.

Networking · 2 min read · 2024-09-01

When SSH Fails, Separate the Failure Layers

"SSH is not working" can mean several different things: the address is wrong, there is no route, nothing is listening on the port, or authentication failed. Restarting the server is not the universal answer.

Networking · 3 min read · 2022-03-23

DHCP Is More Than Automatic IP

DHCP is easier to troubleshoot when treated as a timed client-server exchange that delivers an address plus the parameters a host needs to participate in the network.

Networking · 2 min read · 2021-08-26

Working DNS Does Not Mean the Application Is Healthy

Resolving a domain to an address is an important first step, but DNS cannot tell you whether the service is reachable, the certificate matches, or the application itself is working. Successful name resolution is not system health.

PCB Bring-Up & Hardware · 2 min read · 2024-07-10

Define the Questions Before Calling EVT a Success

Seeing a prototype power on is a major relief, but engineering validation requires knowing which questions the board has actually answered. One LED cannot validate power, audio, radio behavior, and long-duration operation at the same time.

PCB Bring-Up & Hardware · 2 min read · 2023-06-25

The Antenna Does Not End at the Edge of the Board

A board antenna gives clues about expected behavior, but in a real product the surrounding objects become part of the system. The enclosure, cables, metal parts, and device placement can all change the result. An open-board test is not a guarantee for the finished enclosure.

Embedded Audio & Voice · 2 min read · 2024-11-09

Jitter Buffer: Paying With Delay for Continuous Audio

Audio packets do not arrive at perfectly regular intervals even when they travel the same network path. A jitter buffer waits long enough to smooth that variation, but the waiting itself increases conversational latency.

Embedded Audio & Voice · 2 min read · 2024-07-12

Voice-Agent Speed Is More Than Model Speed

Voice-agent latency is often reduced to how quickly the model generates text. In reality, the conversation includes audio capture, network transport, end-of-speech detection, transcription, generation, speech synthesis, and playback.

Embedded Audio & Voice · 2 min read · 2022-12-22

If I2S Is Silent, Check the Format Contract First

Bytes moving over I2S do not prove that both devices interpret those bytes the same way. Sample width, channel layout, clock relationships, and data alignment all have to match. A silent speaker is not automatically an amplifier problem.

Web & Control Plane · 2 min read · 2024-01-12

What Git History Adds to a Blog

In a Git-backed blog, content files and their change history live in the same system. You can trace when a sentence changed, when metadata moved, and which edits can be reverted. But Git alone does not provide the entire publishing experience.

Quick navigationEsc