A film (or "Film Box") capacitor is a non-polarized passive component using a metallized polypropylene or polyester film as its dielectric, instead of the oxide/electrolyte layer an electrolytic capacitor uses. In Open Maker Studio, it does not have Blockly code blocks — it interacts directly with the real-time SPICE analog simulator, most commonly for high-frequency bypass/decoupling and AC-safety roles rather than bulk energy storage.
1. Schematic Symbol
Non-polarized capacitor symbol — two straight plates, no polarity marking (can be wired either way):
2. Characteristics & Real-World Ratings
- Polarity: Non-polarized. Can be wired in either direction.
- Characteristics: Low capacitance value (1pF to 1µF) with low internal resistance (low ESR) — much lower leakage and better high-frequency response than an electrolytic (see [[4.9 Capacitors|4.9 Capacitors (Electrolytic)]]). Used for bypassing high-frequency noise, not bulk energy storage.
- X2 safety rating: OMS's Film Box Capacitor is modeled on a real X2-class AC safety capacitor
(the canvas artwork prints "
{voltage}V~ X2" directly on the box, matching a real X2-rated part's markings) — X2-rated capacitors are specifically certified for direct connection across AC mains line-to-line, which is why the component's Voltage Rating options (250V/275V/400V/630V) match real X2 capacitor voltage classes rather than typical low-voltage DC ratings. - Real leakage modeled: OMS models a ~10GΩ DC leakage resistance (about 0.5pA at 5V) — 1000× more ideal than the electrolytic model (~10MΩ, ~500nA at 5V) — matching how film capacitors have genuinely lower real-world leakage than electrolytics.
[!NOTE] No Reverse-Polarity Fault: since this part is non-polarized, there's no "wrong way" to wire it — the only fault this component can raise is Overvoltage (exceeding the selected Voltage Rating), unlike the Electrolytic Capacitor which can also fault on reverse polarity.
3. Core Calculations & Math
- Time Constant () of an RC Circuit: the time required to charge a capacitor to
approximately 63.2% of its maximum voltage through a series resistor ():
Where is in ohms and is in Farads. A capacitor is considered fully charged after (99.3%). - Capacitor Impedance (AC Reactance):
As frequency () increases, the capacitor's resistance to AC current decreases, enabling noise signals to bypass straight to GND — the primary reason film capacitors are chosen for high-frequency bypass duty.
4. Bypass, Coupling & AC-Safety Applications
- High-Frequency Decoupling: Paired alongside a bulk electrolytic near a microcontroller's power pins, a small film/ceramic capacitor bypasses fast transient noise the electrolytic's higher ESR and inductance can't respond to quickly enough.
- DC Blocking (AC Coupling): Placed in series with signal wires (like audio outputs) to allow changing signals (AC) to pass while blocking static DC bias voltages — since it's non-polarized, it's safe here regardless of the DC bias direction.
- AC Mains Safety (X2 Class): Real X2-rated film capacitors are used directly across AC mains line-to-line for EMI suppression, since their construction is certified to fail safely (open, not short) under mains transients.
5. Component Properties (Property Inspector)
When you select a Film Box Capacitor on the canvas, you can modify the following parameters in the Property Inspector panel:
- Capacitance (
capacitance): Sets the stored charge capacity in microfarads (µF).- Default:
0.1µF - Range:
0.0001µF to10µF
- Default:
- Max Voltage Rating (
maxVoltage): Sets the maximum safe working voltage for the film capacitor.- Default:
275V - Options:
50V,100V,250V,275V,400V,630V
- Default:
6. Programming Notes
Capacitors are purely passive analog components and have no associated Blockly blocks. You cannot control a capacitor directly through code. Instead, this capacitor influences the electrical behavior of connected components — for example, a high-frequency bypass capacitor keeps a nearby ADC reading (via board_analog_read) stable against fast power-rail noise it wouldn't otherwise catch.
7. Simulator Behavior
- Real-time Voltage Readout: While a simulation is running, OMS renders a live text overlay directly on the capacitor body — not a hover-only tooltip — showing the voltage across it whenever it exceeds ~0.01V. Only voltage is shown; there's no current readout on this component.
- Overvoltage Only: Since this part is non-polarized, only an
Overvoltagewarning can appear (no reverse-polarity check exists for this component) — exceeding the Voltage Rating recolors the box and shows a "⚠ OVERVOLTAGE" label, the same purely visual, component-local check described for the Electrolytic Capacitor (this component'sfaults: []array is also empty — it doesn't reach the Circuit Inspector's Faults tab either). - No Oscilloscope Tool: OMS doesn't have a dedicated oscilloscope/scope feature for plotting a
component's charge/discharge curve over time — the closest real tool is the Plotter
(
blockly/extensions/advanced/plotter.ts), which graphs values your own code sends over serial, not a component's real SPICE voltage automatically.

