Film Capacitors

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…

Film Box Capacitor

At a glance

Pins and properties exactly as the circuit editor and simulator define this part. The text below explains how to use them.

Pinout

Pinout of the Film Box Capacitor, drawn as in the circuit editor. Select a label to see that pin in the table below.

Pins

Pins of this part
PinLabelType
A1Bidirectional
B2Bidirectional

Properties

What you can change in the Property Inspector.

Properties of this part
PropertyRange or choicesDefault
Capacitance0.0001 to 10 µF0.1 µF
Voltage Rating50V, 100V, 250V, 275V, 400V, 630V275V

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):

A B

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 (τ\tau) of an RC Circuit: the time required to charge a capacitor to approximately 63.2% of its maximum voltage through a series resistor (RR):
    τ=R×C\tau = R \times C
    Where RR is in ohms and CC is in Farads. A capacitor is considered fully charged after 5τ5\tau (99.3%).
  • Capacitor Impedance (AC Reactance):
    Xc=12πfCX_c = \frac{1}{2\pi f C}
    As frequency (ff) 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 to 10 µF
  • Max Voltage Rating (maxVoltage): Sets the maximum safe working voltage for the film capacitor.
    • Default: 275 V
    • Options: 50 V, 100 V, 250 V, 275 V, 400 V, 630 V

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 Overvoltage warning 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's faults: [] 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.
Film Capacitors — OMS Parts