Add: Circular display connector (bottom05flip) (#380)

- [x] This PR requires #378 (top contact 15pos)
- [x] The screen to be tested

---------

Co-authored-by: Richard Lin <[email protected]>

Author: Suke0811

edg/parts/Lcd_Er_Tft1_28_3.py

@@ -0,0 +1,104 @@
+from .PassiveConnector_Fpc import Fpc050Bottom
+from ..abstract_parts import *
+
+
+class Er_Tft_128_3_Outline(InternalSubcircuit, FootprintBlock):
+    """Footprint for TFT panel outline"""
+
+    def contents(self) -> None:
+        super().contents()
+        self.footprint('U', 'edg:Lcd_Er_Tft1_28_3_Outline', {},
+                       'EastRising', 'ER-TFT1.28-3',
+                       datasheet='https://www.buydisplay.com/download/manual/ER-TFT1.28-3_Datasheet.pdf')
+
+
+class Er_Tft_128_3_Device(InternalSubcircuit, Nonstrict3v3Compatible, Block):
+    """15-pin FPC connector for the ER-TFT1.28-3 device"""
+
+    def __init__(self) -> None:
+        super().__init__()
+
+        self.conn = self.Block(Fpc050Bottom(length=15)) # Pin numbering in the doc is flipped in the footprint
+
+        # Power pins
+        self.vdd = self.Export(self.conn.pins.request('12').adapt_to(VoltageSink(
+            voltage_limits=self.nonstrict_3v3_compatible.then_else(
+                (2.5, 3.6) * Volt,  # abs max is 4.6v
+                (2.5, 3.3) * Volt),
+        )))
+
+        self.gnd = self.Export(self.conn.pins.request('15').adapt_to(Ground()))
+        # Backlight control
+        self.ledk = self.Export(self.conn.pins.request('14'))
+        self.leda = self.Export(self.conn.pins.request('13'))
+
+        dio_model = DigitalBidir.from_supply(
+            self.gnd, self.vdd,
+            voltage_limit_tolerance=(-0.3, 0.3)*Volt,
+            input_threshold_factor=(0.3, 0.7)
+        )
+
+        self.rs = self.Export(self.conn.pins.request('11').adapt_to(DigitalSink.from_bidir(dio_model)))
+
+        # Control pins
+        self.spi = self.Port(SpiPeripheral.empty())
+        self.cs = self.Export(self.conn.pins.request('10').adapt_to(DigitalSink.from_bidir(dio_model)))
+        self.connect(self.spi.sck, self.conn.pins.request('9').adapt_to(DigitalSink.from_bidir(dio_model)))
+        self.connect(self.spi.mosi, self.conn.pins.request('8').adapt_to(DigitalSink.from_bidir(dio_model)))
+
+        self.miso_nc = self.Block(DigitalBidirNotConnected())
+        self.connect(self.spi.miso, self.miso_nc.port)
+
+        self.rst = self.Export(self.conn.pins.request('7').adapt_to(DigitalSink.from_bidir(dio_model)))
+
+        # Capacitive Touch Panel (CTP)
+        self.ctp_i2c = self.Port(I2cTarget(DigitalBidir.empty(), addresses=[0x15]),)
+
+        self.ctp_vdd = self.Export(self.conn.pins.request('6').adapt_to(VoltageSink(
+            voltage_limits=(2.7, 3.6) * Volt,
+            current_draw=(5 * uAmp, 2.5 * mAmp)
+        )))
+
+        self.connect(self.gnd, self.conn.pins.request('5').adapt_to(Ground()))
+
+        self.ctp_rst = self.Export(self.conn.pins.request('4').adapt_to(DigitalSink.from_bidir(dio_model)))
+        self.ctp_int = self.Export(self.conn.pins.request('3').adapt_to(DigitalSink.from_bidir(dio_model)))
+        self.connect(self.ctp_i2c.sda, self.conn.pins.request('2').adapt_to(dio_model))
+        self.connect(self.ctp_i2c.scl, self.conn.pins.request('1').adapt_to(DigitalSink.from_bidir(dio_model)))
+
+
+class Er_Tft_128_3(Lcd, Resettable, Block):
+    """GC9A01-based 1.28" 240x240 TFT, with optional CST816S-based capacitive touch panel."""
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.ic = self.Block(Er_Tft_128_3_Device())
+        self.gnd = self.Export(self.ic.gnd, [Common])
+        self.pwr = self.Export(self.ic.vdd, [Power])
+        self.spi = self.Export(self.ic.spi)
+        self.cs = self.Export(self.ic.cs)
+        self.dc = self.Export(self.ic.rs)
+        # touch interface
+        self.ctp_i2c = self.Export(self.ic.ctp_i2c, optional=True, doc='Touch panel interface i2c')
+        self.ctp_rst = self.Export(self.ic.ctp_rst, optional=True, doc='Touch panel interface')
+        self.ctp_int = self.Export(self.ic.ctp_int, optional=True, doc='Touch panel interface')
+
+    def contents(self):
+        super().contents()
+        self.connect(self.reset, self.ic.rst)
+        self.require(self.reset.is_connected())
+
+        self.lcd = self.Block(Er_Tft_128_3_Outline())  # for ic outline
+
+        self.connect(self.ic.ledk.adapt_to(Ground()), self.gnd)
+        forward_current = (24, 30)*mAmp
+        forward_voltage = 2.9*Volt
+        self.led_res = self.Block(Resistor(
+            resistance=((self.pwr.link().voltage.upper() - forward_voltage) / forward_current.upper(),
+                        (self.pwr.link().voltage.lower() - forward_voltage) / forward_current.lower())))
+        self.connect(self.led_res.a.adapt_to(VoltageSink(current_draw=forward_current)), self.pwr)
+        self.connect(self.led_res.b, self.ic.leda)
+        self.connect(self.pwr, self.ic.ctp_vdd)
+        self.require(self.ctp_i2c.is_connected() == self.ctp_rst.is_connected())
+        self.require(self.ctp_i2c.is_connected() == self.ctp_int.is_connected())
+

edg/parts/__init__.py

@@ -114,6 +114,7 @@
 from .Neopixel import Neopixel, Ws2812b, Sk6812Mini_E, Sk6805_Ec15, Sk6812_Side_A, NeopixelArray, NeopixelArrayCircular
 from .Lcd_Qt096t_if09 import Qt096t_if09
 from .Lcd_Ch280qv10_Ct import Ch280qv10_Ct
+from .Lcd_Er_Tft1_28_3 import Er_Tft_128_3
 from .Oled_Er_Oled_091_3 import Er_Oled_091_3
 from .Oled_Er_Oled_096_1_1 import Er_Oled_096_1_1
 from .Oled_Er_Oled_096_1c import Er_Oled_096_1c

examples/edg.pretty/Lcd_Er_Tft1_28_3_Outline.kicad_mod

@@ -0,0 +1 @@
+(footprint "Lcd_Er_Tft1_28_3_Outline"(version 20241229) (generator "pcbnew") (generator_version "9.0")(layer "F.Cu" )(descr "Outline for the 1.28 inch 240x240 IPS TFT LCD Round Circle Capacitive Touch Screen series LCDs. Connector dimensions (on User.Comments layer, with FPC folded over underneath the board, contact facing away from module) is from the Outline Drawing.")(property "Reference" "REF**"(at 0 -14 0)(layer "F.SilkS" )(uuid "f2e2f675-ba12-4850-bfa4-ec3fe8671742")(effects(font(size 1 1)(thickness 0.15))))(property "Value" "Lcd_Er_Tft1_28_3_Outline"(at 0 -0.5 0)(layer "F.Fab" )(uuid "9e0eb252-2082-4c15-95e3-15c23edf5f3c")(effects(font(size 1 1)(thickness 0.15))))(property "Datasheet" ""(at 0 0 0)(layer "F.Fab" )(hide yes)(uuid "950c88b4-3725-4208-8eb5-b28d527d3abf")(effects(font(size 1.27 1.27)(thickness 0.15))))(property "Description" ""(at 0 0 0)(layer "F.Fab" )(hide yes)(uuid "a58a56f1-def7-490f-891c-de667c9a6793")(effects(font(size 1.27 1.27)(thickness 0.15))))(attr exclude_from_pos_files)(fp_circle (center 0 0) (end 16.2 0)(stroke (width 0.1) (type default))(fill no)(layer "F.SilkS" )(uuid "2e62d766-e910-40f3-bede-596eff1d9e4f"))(fp_circle (center 0 0) (end 21.25 0)(stroke (width 0.1) (type default))(fill no)(layer "F.SilkS" )(uuid "d6945a76-c1fe-46e9-88b2-10abd193a137"))(fp_line (start -4.75 24.17) (end -4.75 21.25)(stroke (width 0.1) (type solid))(layer "Cmts.User" )(uuid "9c0bd3ba-bc94-41d1-99c3-cc918afd2a4b"))(fp_line (start 3 23.2) (end 3 23.2)(stroke (width 0.5) (type solid))(layer "Cmts.User" )(uuid "908769fe-c74a-4c9a-928e-cd06bc256925"))(fp_line (start 3.25 21.25) (end -4.75 21.25)(stroke (width 0.1) (type solid))(layer "Cmts.User" )(uuid "ed5bf26a-4179-492b-b841-d397daa25d3c"))(fp_line (start 3.25 21.25) (end 3.25 24.17)(stroke (width 0.1) (type solid))(layer "Cmts.User" )(uuid "7216ebb7-9bda-4856-9a65-8b5610d1ac42"))(fp_line (start 3.25 40.53) (end -4.75 40.53)(stroke (width 0.1) (type solid))(layer "Cmts.User" )(uuid "78d3199f-6925-4f54-a099-b006ead08d6c"))(embedded_fonts no))