Skip to the content
4 layers100 × 81.5 mmTubes Mk. PCB, the printed circuit board in 3D

Sistem monitoring dan analisis data untuk wahana submersible berbasis Teensy 4.1. Proyek ini mencakup kontrol real-time via Ethernet/USB dan alat analisis data hasil pengujian (Data Playback).

Size
100 × 81.5 mm
Copper layers
4
Thickness
1.6 mm
Parts
80
Nets
84
Pads
258
Tracks, vias
511, 42
Pours
5
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
14 Oct 2025
Updated
21 Aug 2026

Overview

Tubes Mk. PCB is an open-source printed circuit board by wangga03, from the wangga03/Tugas-Akhir repository on GitHub. It is a 4-layer board of 100 × 81.5 mm with 80 parts on 84 nets, routed with 511 tracks and 42 vias.

It is built around the ESP32-WROOM-32, HLK-10M05 and HT7333, with the BC847B, B3W-1020 and SRD-05VDC-SL-C among its other parts. Its parts include 24 resistors, 12 capacitors, 12 switches, 10 diodes and 6 ICs. It belongs with the ESP32 boards of this library.

Main components

7

README

README.md

Submersible Monitoring & Analysis System

Sistem monitoring dan analisis data untuk wahana submersible berbasis Teensy 4.1. Proyek ini mencakup kontrol real-time via Ethernet/USB dan alat analisis data hasil pengujian (Data Playback).

🚀 Cara Menjalankan GUI

1. Persiapan Lingkungan (Prerequisites)

Pastikan Anda sudah menginstal Python (disarankan v3.10+) dan library yang dibutuhkan:

bash
pip install PyQt5 matplotlib pyserial numpy

2. Menjalankan Monitoring Real-time

Aplikasi ini digunakan untuk mengontrol wahana dan melihat data sensor secara langsung via Ethernet.

  • Lokasi File: Program/GUI/main.py
  • Cara Run:
    bash
    cd "Program/GUI"
    python main.py
  • Koneksi: Secara default menggunakan IP 192.168.1.170 dan Port 9000. Pastikan laptop Anda berada dalam satu subnet yang sama dengan Teensy (misal IP Laptop: 192.168.1.100).

3. Menjalankan Data Playback & Analysis

Aplikasi ini digunakan untuk memutar ulang (playback) data CSV yang sudah direkam dan melakukan simulasi algoritma DSRA.

  • Lokasi File: Data Pengujian/Program/playback_gui.py
  • Cara Run:
    bash
    cd "Data Pengujian/Program"
    python playback_gui.py

4. Menjalankan via Executable (.exe) - Tanpa Python

Jika Anda tidak ingin menginstal Python, Anda bisa langsung menjalankan file executable yang sudah di-build.

  • Lokasi Folder: GUI/
  • Daftar Aplikasi:
    • SubmersibleMonitor.exe: Untuk monitoring real-time (setara dengan main.py).
    • DataAnalysisTool.exe: Untuk analisis data & playback (setara dengan playback_gui.py).
  • Cara Pakai: Cukup klik dua kali pada file .exe yang diinginkan.

🎮 Daftar Perintah (Control Commands)

Aplikasi GUI mengirimkan perintah teks ke Teensy melalui TCP/IP. Berikut adalah daftar perintah yang tersedia:

1. Kontrol Misi & Pergerakan

PerintahDeskripsi
MANUAL,ONMasuk ke mode kontrol manual (W/S di keyboard aktif).
MANUAL,OFFMemulai misi otomatis (Auto Mission).
F(Manual) Wahana bergerak naik (Up/Forward).
B(Manual) Wahana bergerak turun (Down/Backward).
f / b(Manual) Menghentikan pergerakan naik atau turun.
SPEED,valMengatur kecepatan motor (contoh: SPEED,200).

2. Konfigurasi Sistem

PerintahDeskripsi
PID,kp,ki,kd,pres,max,depths,timesMengirim parameter PID, tekanan permukaan, dan array target misi.
ADAPTIVE_[TYPE],e,sMengatur parameter sampling adaptif (TEMP, DO, PH, COND).
PID_CONTROL,OFFMematikan kontroler PID secara darurat.
SENSOR,[TYPE],[0/1]Menyalakan (0) atau mematikan (1) sensor tertentu.

3. Manajemen Data & SD Card

PerintahDeskripsi
PMemberhentikan (Pause) pengambilan data sampling.
RMelanjutkan (Resume) pengambilan data sampling.
SMengunduh seluruh isi data dari SD Card (Sync Data).
CMenghapus seluruh data di SD Card (Format SD).

🌐 Arsitektur Komunikasi Ethernet (Teensy ↔ PC)

Sistem ini menggunakan koneksi TCP Client-Server berbasis kabel Ethernet untuk pertukaran data kontrol dan telemetri.

1. Stack Teknologi & Library

  • Sisi Wahana (Teensy 4.1):
    • Library: Ethernet.h (W5500) dan FreeRTOS_Teensy.
    • Mode: Server (Mendengarkan koneksi di Port 8080 atau 9000).
    • Thread: Berjalan di EthernetTask terpisah agar sampling sensor tetap presisi.
  • Sisi Desktop (Python GUI):
    • Library: socket (Python Standard Library).
    • Mode: Client (Menghubungkan ke IP Teensy).

2. Mekanisme Pengiriman Data (Send)

Data dikirim dalam format ASCII String yang diakhiri dengan karakter newline (\n) sebagai penanda akhir satu paket data.

  • Contoh (Python): sock.sendall("PID,1.0,0.1,0.01\n".encode())
  • Contoh (C++): client.println("RT,1000,28.5,7.2,10.0,12.5");

3. Mekanisme Penerimaan & Parsing (Receive)

Karena TCP bersifat streaming, data diterima menggunakan Buffer untuk mengumpulkan fragmen karakter sampai ditemukan \n.

  • Teensy: Menggunakan String bufferTerima dan mengecek tiap karakter yang masuk di ethernet_loop().
  • GUI: Menggunakan buffer string dan fungsi split("\n") di dalam timer regular (50ms).

🛠️ Format Raw Data & Respons Teensy

Teensy mengirimkan berbagai tipe respons. GUI akan membedakan tipe data berdasarkan header (kata pertama sebelum koma).

1. Telemetri Real-time (RT)

Dikirim setiap kali sampling dilakukan (default ~20Hz). Format: RT,Timestamp,Temp,pH,DO,Batt,Curr,Depth,Cond,ErrorPID,PWM,TargetDepth,PIDOutput

2. Respons Konfigurasi (CONFIG)

Dikirim saat GUI meminta sinkronisasi atau setelah parameter diubah. Format: CONFIG,Kp,Ki,Kd,Speed,SurfacePres,MaxMotor,DEPTHS,[10 data],TIMES,[10 data],ADAPTIVE,[E/S params],IP,Port GUI memproses ini untuk memperbarui nilai di kotak input secara otomatis.

3. Status & Acknowledgement (ACK, OK, INFO)

Digunakan untuk konfirmasi bahwa perintah telah diterima.

  • ACK_SETIP: Konfirmasi perubahan IP berhasil.
  • INFO: SD Card Initialized: Status perangkat keras.

4. Respons Error (ERR, ERROR)

Digunakan jika terjadi masalah pada sensor atau perintah.

  • ERR: DO Sensor Not Found
  • ERROR: Invalid PID Format

📊 Penjelasan Struktur File CSV (Rekaman)

Data yang direkam melalui tombol "Start Record" di GUI akan disimpan dalam format .csv.

Struktur File CSV:

File ini memiliki Header di baris pertama yang menunjukkan nama sensor yang dipilih saat perekaman.

KolomSatuanDeskripsi
TIMESTAMP_MSmsWaktu relatif sejak Teensy dinyalakan
DOmg/LKadar oksigen terlarut
CURRENTmAArus motor/sistem
PH-Nilai pH air (0-14)
CONDUCTIVITYµS/cmDaya hantar listrik air
TEMPERATURE°CSuhu lingkungan air
DEPTHmKedalaman yang terbaca oleh sensor tekanan
ERROR_PIDmError kedalaman (Target - Aktual)
PWMmsLebar pulsa sinyal motor (Standby biasanya ~1500)

Contoh Isi File:

csv
TIMESTAMP_MS,DO,CURRENT,PH,CONDUCTIVITY,TEMPERATURE,ERROR_PID,PWM,DEPTH
666513,3.855,68.750,8.125,1723.000,28.312,0.058,1442,0.386
666567,3.855,68.750,8.125,1723.000,28.312,0.061,1439,0.388

💻 Contoh Program Parsing (Bahasa C)

Jika Anda ingin memproses data RT menggunakan bahasa C (misalnya di MCU lain atau aplikasi desktop berbasis C), Anda bisa menggunakan fungsi strtok untuk memisahkan data berdasarkan koma.

Contoh lengkap dapat dilihat di file: parser_example.c [blocked]

Potongan Kode Utama:

c
int parse_rt_data(const char *raw_line, TelemetryData *data) {
    char line[256];
    strncpy(line, raw_line, sizeof(line));
    
    char *token = strtok(line, ",");
    if (token == NULL || strcmp(token, "RT") != 0) return 0;
    
    // Parsing satu per satu (sesuai urutan di README)
    if ((token = strtok(NULL, ","))) data->timestamp = strtoul(token, NULL, 10);
    if ((token = strtok(NULL, ","))) data->temperature = atof(token);
    if ((token = strtok(NULL, ","))) data->ph = atof(token);
    // ... dan seterusnya
    return 1;
}

🐍 Contoh Minimal Client (Python)

Berikut adalah script Python sederhana untuk melakukan tes komunikasi (mengirim perintah dan menerima data RT) tanpa menggunakan GUI:

python
import socket

# Konfigurasi - Sesuaikan dengan IP Teensy Anda
TEENSY_IP = "192.168.1.177"
PORT = 8080

def start_test_client():
    try:
        # 1. Inisialisasi Socket TCP
        client = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
        client.settimeout(5.0)
        
        # 2. Mencoba terhubung
        print(f"Menghubungkan ke {TEENSY_IP}:{PORT}...")
        client.connect((TEENSY_IP, PORT))
        print("Berhasil Terhubung!")

        # 3. Contoh Mengirim Perintah (R = Resume Sampling)
        print("Mengirim perintah: R (Resume)")
        client.sendall(b"R\n")
        
        # 4. Loop Menerima Data Telemetri
        print("Mulai mendengarkan data (Tekan Ctrl+C untuk berhenti)...")
        buffer = ""

📟 Contoh Pengiriman Data (Teensy / C++)

Jika Anda ingin menambah data baru yang dikirim dari Teensy ke GUI, gunakan format client.print() dan akhiri dengan client.println() agar terdeteksi sebagai satu baris utuh oleh GUI:

cpp
#include <Ethernet.h>

// Mengirim data ke PC melalui objek EthernetClient yang aktif
void kirimDataKePC(EthernetClient &client) {
    // 1. Siapkan data sensor
    unsigned long ts = millis();
    float suhu = 29.5;
    float ph = 7.4;
    float kedalaman = 1.5;

    // 2. Kirim dengan format CSV (Header,Data1,Data2,...)
    // PENTING: Gunakan print() untuk data awal dan tengah
    client.print("RT,");        // Header paket
    client.print(ts);           // Data 1
    client.print(",");          // Pemisah
    client.print(suhu);         // Data 2
    client.print(",");          // Pemisah
    client.print(ph);           // Data 3
    client.print(",");          // Pemisah
    
    // PENTING: Gunakan println() untuk data terakhir agar mengirim karakter '\n'
    client.println(kedalaman);  // Data Terakhir + Newline
}

📥 Cara Menerima & Parsing Perintah (Teensy / C++)

Untuk menerima perintah dari GUI (seperti tombol Klik atau input Nilai PID), Anda perlu mengumpulkan karakter sampai menemukan \n, lalu memisahkan datanya menggunakan fungsi indexOf dan substring.

cpp
void terimaDataDariPC(EthernetClient &client) {
    static String buffer = ""; // Buffer statis untuk menyimpan fragmen teks

    while (client.available()) {
        char c = client.read();
        if (c == '\n') {
            // --- 1. Contoh Parsing Tombol Tunggal ---
            if (buffer == "P") {
                Serial.println("Perintah diterima: PAUSE SAMPLING");
            } 
            else if (buffer == "R") {
                Serial.println("Perintah diterima: RESUME SAMPLING");
            }

            // --- 2. Contoh Parsing Data Multi-Parameter (PID) ---
            // Format yang dikirim GUI: "PID,kp,ki,kd"
            else if (buffer.startsWith("PID,")) {
                int comma1 = buffer.indexOf(',');
                int comma2 = buffer.indexOf(',', comma1 + 1);
                int comma3 = buffer.indexOf(',', comma2 + 1);

                // Mengambil nilai di antara koma
                float kp = buffer.substring(comma1 + 1, comma2).toFloat();
                float ki = buffer.substring(comma2 + 1, comma3).toFloat();

Catatan: Pastikan kabel Ethernet terhubung dengan baik dan konfigurasi IP statis pada Windows sudah benar sebelum menjalankan script di atas.

Parts

80
QtyValueFootprintReferences
8100nFPCM_Capacitor_SMD_AKL:C_0805_2012MetricC1, C3, C6, C7, C8, C9, C10, C11
8220RPCM_Resistor_SMD_AKL:R_0805_2012MetricR1, R3, R9, R11, R14, R16, R17, R19
6BC847BBC847B:SOT100P230X110-3NQ1, Q2, Q3, Q4, Q5, Q6
5LED_0805_RedPCM_LED_SMD_AKL:LED_0805_2012MetricLED1, LED2, LED3, LED4, LED5
410KPCM_Resistor_SMD_AKL:R_0805_2012MetricR20, R21, R22, R23
41KPCM_Resistor_SMD_AKL:R_0805_2012MetricR5, R7, R8, R24
41N4007_SMDPCM_Diode_SMD_AKL:D_SMAD1, D2, D3, D4
4B3W-1020B3W_1020:SW_B3W-1020_OMRS1, S2, S3, S4
4DNPPCM_Resistor_SMD_AKL:R_0805_2012MetricR2, R10, R15, R18
4PC817PC817:DIL04IC2, IC3, IC4, IC5
4PINHD_1x2_MaleConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalSW1, SW2, SW3, SW4
4SRD-05VDC-SL-CSRD-05VDC-SL-C:RELAY_SRD-05VDC-SL-CK1, K2, K3, K4
4Terminal BlockTerminalBlock_Phoenix:TerminalBlock_Phoenix_PT-1,5-3-5.0-H_1x03_P5.00mm_HorizontalJ3, J4, J5, J6
310uFPCM_Capacitor_SMD_AKL:C_0805_2012MetricC2, C4, C5
312KPCM_Resistor_SMD_AKL:R_0805_2012MetricR4, R12, R13
1220uF_25VCapacitor_THT:CP_Radial_D8.0mm_P3.50mmC12
1470RPCM_Resistor_SMD_AKL:R_0805_2012MetricR6
1ESP32-WROOM-32ESP32-WROOM-32:MODULE_ESP32-WROOM-32IC1
1FTDI PinsConnector_PinHeader_2.54mm:PinHeader_1x06_P2.54mm_VerticalJ2
1HLK-10M05HLK-10M05:CONV_HLK-10M05PS1
1HT7333HT7333:IC_HT7333U1
1LOGOLOGOG***
1PESD5V0S1BAPCM_Diode_SMD_AKL:D_SOD-323_TVSD5
1Screw_Terminal_2_P5.00mmTerminalBlock_Phoenix:TerminalBlock_Phoenix_PT-1,5-2-5.0-H_1x02_P5.00mm_HorizontalJ1

The 78 most common of 80 parts.

More from wangga03/Tugas-Akhir

1
  • 2 layers100 × 100 mmAUV Controller, the printed circuit board in 3D

    AUV Controller

    wangga03/Tugas-Akhir

    Sistem monitoring dan analisis data untuk wahana submersible berbasis Teensy 4.1. Proyek ini mencakup kontrol real-time via Ethernet/USB dan alat analisis data hasil pengujian (Data Playback).

    5 parts

Similar boards

  • 2 layers133 × 106 mm8-channel relay, the printed circuit board in 3D

    8-channel relay

    akashh218/ESP32-8-Channel-Smart-Switch-PCB

    ESP32-based 8-channel smart switch PCB for wireless control of multiple electrical loads, featuring relay interfaces and a compact PCB design.

    86 parts
  • 2 layers232 × 110 mmRelay8, the printed circuit board in 3D

    Relay8

    YORROY123/kicad-scripted-pcb

    Three KiCad 10 PCBs designed entirely as Python code with layered verification

    65 parts1MIT
  • 2 layers80 × 35.6 mmIrouette, the printed circuit board in 3D

    Irouette

    rletendu/irouetteV2

    IrouetteV2

    32 partsGPL-2.0
  • 2 layers48 × 29 mmNoiStop, the printed circuit board in 3D

    NoiStop

    pareror/UnNomeCheTiIspira

    HackTurin 2026

    14 parts2
  • 2 layers52.5 × 88.5 mmESP32-2-Relay, the printed circuit board in 3D

    ESP32-2-Relay

    Shuzukochan/ESP32-2-Relay

    45 partsCERN-OHL-P-2.0

Questions

How big is the Tubes Mk. PCB PCB?

It measures 100 × 81.5 mm and has 4 copper layers, 1.6 mm thick.

What parts does the Tubes Mk. PCB use?

80 parts, built around the ESP32-WROOM-32, HLK-10M05, HT7333 and BC847B. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Tubes Mk. PCB KiCad files?

From the wangga03/Tugas-Akhir repository on GitHub, at the commit this page was made from: the board is Main-Board/Tubes Mk. PCB/Tubes Mk. PCB/Tubes Mk. PCB.kicad_pcb and its schematic Main-Board/AUV_Controller/AUV_Controller.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Tubes Mk. PCB design in my own project?

Its repository states no licence, so its author keeps all rights: ask wangga03 before reusing the design.