Bir PLC programı ilk devreye almada anlaşılır görünebilir; fakat altı ay sonra arızayı araştıran kişi aynı mühendis olmayabilir. Dokümantasyonun amacı bütün kodu tekrar anlatmak değil, makinenin davranışıyla yazılım arasındaki ilişkiyi görünür kılmaktır. İyi bir teslim paketi, bakım ekibinin tahmin yürütmesini ve riskli denemeler yapmasını azaltır.
01Kodun ne yaptığından önce neden yaptığını yazın
Q0.3 aktif olur açıklaması çoğu zaman kodun kendisini tekrar eder. Buna karşılık “Ürün sabitlenmeden kesici ilerlemesini engeller; sıkma teyidi kaybolursa çevrim durur” açıklaması işlevsel niyeti aktarır. Özellikle kilitlemeler, zaman aşımı değerleri ve yeniden başlatma koşulları açıklama gerektirir.
Sembolik isimler de bu niyetin bir parçasıdır. Ekipman, işlev ve durum aynı düzen içinde adlandırılırsa yeni bir istasyona geçildiğinde programın dili değişmez. Üreticinin programlama kılavuzu, blok arayüzü ve veri yapısı gibi teknik kararlar için iyi bir temel sunar; projenin kendi isimlendirme kuralları bunun üzerine yazılır.
02I/O listesi yaşayan bir belge olmalıdır
Liste yalnızca giriş-çıkış adreslerinden oluşmamalıdır. Fiziksel ekipman etiketi, klemens bilgisi, sinyal türü, normal durum ve yazılımdaki sembol birbiriyle eşleştirilmelidir. Analog giriş için mühendislik aralığı ve kopuk sensör davranışı da belirtilir. Elektrik şemasında başka, programda başka isim kullanılan sinyal servis sırasında zaman kaybettirir.
| Alan | Örnek içerik | Sağladığı yarar |
|---|---|---|
| Ekipman | İstasyon 2 sıkma sensörü | Fiziksel noktayı tanımlar |
| Sembol | Clamp2_Closed |
Kodda aramayı kolaylaştırır |
| Mantık | Aktifken sıkma kapalı | NO/NC yorum hatasını azaltır |
| Bağlantı | Modül/kanal ve klemens | Saha eşlemesini sağlar |
| Arıza davranışı | Teyit süresinde gelmezse çevrim bekler | Beklenen sonucu açıklar |
03Durum makinesini görünür kılın
Otomatik çevrim, açıklamasız bitlerin birleşimi yerine tanımlı durumlar üzerinden anlatılabilir: bekleme, hazırlık, işleme, boşaltma ve arıza gibi. Her geçişin koşulu, iptal nedeni ve zaman aşımı belirtilir. Manuel moddan otomatiğe dönüşün hangi durumda mümkün olduğu özellikle önemlidir.
Bir örnek: parça algılanınca sıkma komutu veriliyor, teyit gelince işleme başlıyor olsun. Teyit gelmediğinde yalnızca bir alarm kodu değil; hangi komutun verildiği, hangi geri bildirimin beklendiği ve yeniden denemenin şartı da belgelenmelidir. Bu açıklama, bakım personelinin çevrim bitlerini elle zorlayarak ilerletme ihtiyacını azaltır.
04Yedek dosyası ile geri dönüş planı aynı şey değildir
Bir proje klasörünün kopyasını almak başlangıçtır. Kullanılan mühendislik yazılımı sürümü, cihaz firmware bilgileri, kütüphaneler, lisans ihtiyacı ve gerekli erişim bilgileri de yönetilmelidir. Erişim parolaları herkese açık yorumlara yazılmaz; işletmenin yetki yönetimine uygun biçimde saklanır.
Geri dönüş planı, hangi dosyanın hangi cihazla eşleştiğini ve değişiklik başarısız olursa nasıl eski duruma dönüleceğini açıklar. HMI, sürücü, reçete ve ağ ayarları PLC projesinden ayrı bulunabilir. Paket, bütün sistemin tekrar kurulmasını mümkün kılmalıdır. Yedeğin kullanılabilirliği, güvenli bir test ortamında veya planlı bakımda doğrulanır.
05Değişiklik kaydı bakımın hafızasıdır
“Son sürüm”, “son_son” gibi adlar yerine tarih ve sürümle ilişkilendirilmiş bir değişiklik kaydı kullanılmalıdır. Kayıtta değişikliğin nedeni, etkilenen bloklar, test edilen senaryolar ve onaylayan taraf yer alır. Bir zamanlayıcının 2 saniyeden 5 saniyeye çıkarılması, küçük görünse de mekanik veya proses problemini gizliyor olabilir; gerekçe önemlidir.
Versiyon kontrolü kullanılıyorsa üreticinin dosya yapısına uygun yöntem seçilir. Bütün projeler satır bazlı fark göstermeye elverişli değildir. Bu durumda okunabilir dışa aktarımlar, sürüm etiketleri ve test raporları birlikte değerlendirilir. Sadece dosyanın değiştiğini bilmek, davranışın neden değiştiğini açıklamaz.
06Teslimde bulunması gereken çekirdek paket
- Kaynak proje, sürüm bilgisi ve doğrulanmış geri yükleme yöntemi.
- Elektrik şemasıyla uyumlu I/O ve ağ cihazı listesi.
- Otomatik çevrim, mod geçişleri ve kritik kilitlemeler.
- Alarm açıklamaları ve güvenli teşhis sırası.
- HMI/sürücü yedekleri ve parametre setleri.
- Kabul testleri, bilinen kısıtlar ve değişiklik geçmişi.
Dokümantasyonun kalitesi sayfa sayısıyla değil, bir başkasının sistemi güvenli biçimde anlamasına ne kadar yardımcı olduğuyla ölçülür. Makinede yapılan değişiklik belgeye işlenmiyorsa, en iyi başlangıç dokümanı bile kısa sürede eski hale gelir.
07Örnek doğrulama senaryosu
Bir bakım mühendisinin çevrimin üçüncü adımda neden beklediğini araştırdığını düşünelim. Durum listesi beklenen sensörü, izin koşullarını ve zaman aşımını gösteriyorsa teşhis doğrudan ölçüme yönelir. Sadece adreslerden oluşan bir programda ise aynı bilgi birçok blok arasında aranır. Teslim testinde projeyi hazırlamayan bir kişinin örnek arızayı dokümanla bulması denenebilir. Bu uygulama, belgenin varlığından çok işe yararlığını değerlendirmeye yardımcı olur.
Teknik kaynaklar ve ileri okuma
Ürün ve sürüm özelindeki değerler için ilgili üreticinin güncel dokümanı esas alınmalıdır. Yukarıdaki hesaplar ve senaryolar açıklama amaçlı mühendislik örnekleridir.
