EXETHIO Kullanım Klavuzu R5.02b

Transkript

EXETHIO
Expkits
Genel Maksatlı I/O MODÜLÜ
Sürüm 5.02b
Professional Development Kits
Sürüm 5.02b
TA
SL
AK
DÖ
K
Kullanım Klavuzu
ÜM
AN
EXETHIO
Expkits
©2012-2013 Expkits Inc. www.expkits.com
1
EXETHIO
Expkits
Sürüm 5.02b
Güvenlik Uyarısı
ÜM
AN
ESD Önlemleri
DÖ
K
Almış olduğunuz ürünü kullanmaya başlamadan evvel bu kullanım klavuzunu iyice
inceleyiniz. Ürünün kullanımına yönelik önemli hususların olabileceğini unutmayınız.
Almış olduğunuz ürüne elektrik verirken bu kullanım klavuzunda belirtilen talimatları
iyice okuduğunuzdan, ürünün çalışma koşullarının belirtildiği şekilde sağlandığından
ve tüm gerekli işlemlerin kullanım klavuzuna uygun olduğundan emin olunuz.
TA
SL
AK
İnsan vücudu elektrostatik yükleri biriktirebilen bir yapıya sahiptir. Bu yük
kolayca elektronik cihazlara zarar verebilir. Tüm elektronik ürünler gibi bu ürün de
elektrostatik boşalmalara (ESD) karşı hassas bir üründür. Ürünü kullanırken çıplak
elle ürüne temas etmekten kaçınınız.
2
EXETHIO
Expkits
Sürüm 5.02b
İçindekiler
1. Genel Bakış
2. Özellikler
3. Paket İçeriği
4. Cihaz Kurulumu
5. GUI
4
4
5
5
a) Cihaz Listesi ve Kontrol Paneli
b) Çıkış Durum Kontrol Paneli
c) Giriş Durum Paneli
ÜM
AN
6
d) Çıkış Tümü Açık, Tümü Kapalı, Ters Çevir Butonları
a) ETHIO() Sınıfı
DÖ
K
6. GUI Kullanımı
7. DLL ve API Kullanımı
6
7
7
7
7
8
8
ETHIO.FindDevices()9
ETHIO.ConnectDevice(string ip)
9
AK
ETHIO.DeviceList9
9
ETHIO.SetDeviceConfigUseMac() 9
ETHIO.FindDeviceMacAddress() 9
ETHIO.GetVersion() 9
TA
SL
ETHIO.ResetDeviceConfig(int MACData)
b) Device() Sınıfı
9
Device.SetPin(int pin, int status) 10
Device.Ping()10
Device.SetDeviceName(string deviceName)
10
Device.SetConfig (DeviceInfo
10
config, bool forceProceed) Device.Reset()10
8. Notlar
10
3
EXETHIO
Expkits
Sürüm 5.02b
1. Genel Bakış
EXETHIO internet üzerinden çeşitli giriş çıkış fonksiyonlarının gerçekleştirilebilmesi
amacıyla geliştirilmiştir. Ethernet hattı üzerinden gerçek dünyadaki uygulamaları
yapabilmenizi sağlar. Lamba, ses sistemleri gibi değişik cihazların kontrolü, çeşitli sensörlerin
izlenmesi, anahtar ve değişik dijital girişlerin takip edilmesi işlerini yapabilir.
ÜM
AN
Ürün bir API DLL vasıtasıyla veya direkt komutlar ile kontrol edilebilir. Visual Basic .NET,
Delphi .NET, Visual C# ve bunlar gibi dillerle hazırlanmış yazılımlar ürünle birlikte verilen DLL
dosyasını kullanarak ürünün tüm fonksiyonlarına kolayca erişebilirler. Bunun dışında kalan
diller için cihaz komut seti ile iletişim oldukça basite indirgenmiştir. Cihazı herhangi bir dil
veya ağ haberleşmesi yaparak UDP komutlar gönderebilen cihaz ile kullanmanız mümkündür.
Otomasyon firması iseniz veya PLC benzeri ürünler ile sıkça uğraşıyorsanız. Size sunulan
DLL ve örnek C# kaynak kod ile kendi uygulamalarınızı hızlıca geliştirerek kendi ürününüz
olarak kullanabilirsiniz.
DÖ
K
Hobi olarak elektronikle uğraşanlar için de çok kolay bir şekilde kontrol işlemleri yapılmasına
olanak sağlayan bir üründür. Hızlı bir şekilde ev otomasyonu, bilgi işlem odalarındaki bir takım
kontrol otomasyon işlemleri ve daha farklı lamba, elektrikli cihazların kontrolü yapabilir.
Girişlerindeki değişiklikleri hızlıca izlenmesine olanak tanır.
2. Özellikler
TA
SL
AK
• Ethernet haberleşme portu.
→→ DHCP desteği ile otomatik IP alma.
→→ Web arayüzü üzerinden giriş/çıkış durumlarını izleyebilme.
→→ NETBIOS desteği ile ip bilmeksizin web arayüzüne giriş.
• 12 Adet röleli çıkış.
• 220V/10A anahtarlama kapasitesi.
• USB port beslemesi ile tüm fonksiyonları kullanabilme.
• 8 Adet opto izolatör giriş. ( Kuru Kontak )
• Cihaz evrensel MAC adresine sahiptir.
• Besleme indikatör ledi.
• Ethernet haberleşme ledleri.
• Kolay takılabilir vida tip klemensler.
• Real Time Clock.
• Ray ve Duvar tipi plastik kutu.
• Cihaz ayarları ve testinin yapılabileceği GUI uygulama.
• Uygulama geliştiriciler için .NET DLL API
• Üretici tarafından firmware yükseltme desteği.
4
EXETHIO
Expkits
Sürüm 5.02b
•
•
•
•
•
Endüstriyel RT-209 ray tipi modül kutu.
RS232 haberleşme portu. (Opsiyonel)
RS485 haberleşme portu. (Opsiyonel)
USB haberleşme portu. (Opsiyonel)
Isı-Nem Ölçme imkanı. (Opsiyonel)
• 1 adet EXETHIO
• 1 adet ethernet kablosu
• 1 adet uygulama DVD ’si
TA
SL
AK
DÖ
K
4. Cihaz Kurulumu
ÜM
AN
3. Paket İçeriği
5
EXETHIO
Expkits
Sürüm 5.02b
Cihazda 12 adet röle çıkış vardır. Bu çıkışlar 5.08mm vida tip klemensler ile 2 şer 2 şer
kullanılırlar. PC programı yada kendi yazdığınız arayüzünüz ile “ex-ethioapinet.dll” kullanarak
bu çıkışları açıp kapatılabilir. Bu şekilde istenilen çıkışlar kontrol edebilirsiniz.
ÜM
AN
Cihazda 8 adet optokuplörlü giriş vardır. Bu optolar kuru kontak olarak çalışır. İlk klemenste
bulunan ortak uç ile opto girişleri birbirlerine kısa devre edilirse, o girişlerden bir bilgi geldiği
anlaşılır. COM ucuna 12-24V DC bağlayınız. Diğer uçlar sizin input devrelerinizin eksi uçlarıdır.
Cihaz 7V-20V 0,5A AC/DC kaynak ile beslenebilir. 9V DC kaynaktan 450mA civarında akım çeker.
Cihaz aynı zamanda USB port beslemesi ile de kullanılabilir. Tüm fonksiyonlar usb besleme
gücü ile kullanılabilir. Cihaz usb hub çıkışında eğer hub adaptör ile beslenmiyorsa yeterli akım
çekemeyeceği için stabil çalışmayacaktır.
5. GUI
d
c
TA
SL
AK
a
DÖ
K
b
GUI, EXETHIO kartını test edebilmeniz için API kullanarak geliştirilmiş test programıdır. CD
içerisindeki “Test Program” klasörünü bilgisayarınıza kopyalayınız. CD içerisinde çalıştırılırsa
hata verecektir. “GUI.exe” çalıştırılarak program açılır. Programın çalışması için Microsoft
® .NET® Framework v4.0 bilgisayarınızda yüklü olmalıdır. Yüklü değil ise CD içerisinden
framework yüklenmelidir. Cihazı ethernet portundan ağa bağlayıp, programı kullanmaya
başlayabilirsiniz.
a) Cihaz Listesi ve Kontrol Paneli
Bu panel üzerinde mevcut cihazların listesi ve o anda aktif edilen cihazın donanım ve
konfigürasyon bilgileri bulunur. Ayrıca seçili cihaz için Ayarlar penceresini açmak için “Ayarlar
“ butonu vardır. “Cihaz Listele” butonu ile algılanmayan cihazlar “+” cihaz ekleme butonuna
tıklanarak aratılıp listeye eklenebilir.
6
EXETHIO
Expkits
Sürüm 5.02b
b) Çıkış Durum Kontrol Paneli
Bu panel üzerinde seçili cihazın çıkışlarının durumlarını gösteren ve bu çıkışları kontrol
etmeye yarayan butonlar yer alır. İlgili çıkışa ait buton grubu çıkışın o anki durumuna göre ON
veya OFF olarak görüntülenir. Eğer cihaz ile bağlantı kesilmişse bu panel gri renkte görünür.
c) Giriş Durum Paneli
ÜM
AN
Giriş durum paneli seçili cihazın girişlerinin durumlarını sürekli gözetleyen ve bildiren
göstergeler içerir. Bu göstergeler girişlerin durumuna göre YEŞİL veya KIRMIZI olarak durum
değiştirir. Cihazın girişleri tasarımı gereği boşta iken yeşil durumda yani aktiftir.
d) Çıkış Tümü Açık, Tümü Kapalı, Ters Çevir Butonları
Cihazın çıkışlarının tümünü aynı anda açmak, kapatmak veya mevcut durumlarını tersine
çevirmek gibi API’ nin kullanımına basit örnek teşkil edecek fonksiyonları içeren butonlardır.
DÖ
K
6. GUI Kullanımı
TA
SL
AK
GUI programı açıldığında bir cihaza bağlanmak veya mevcut tüm cihazları listeleyebilmek
için “Cihazları Listele” butonuna tıklanır. Eğer tarama sırasında bağlantı sorunları nedeniyle
hiçbir cihaz bulunamazsa elle girmeniz için bilinen bir cihazın ip adresi istenir. Elle listeye
cihaz ekleme işlemi “+” butonuna tıklanarakta gerçekleştirilebilir.
aktifleşmez.
Listeden seçilen cihaza ait konfigürasyon bilgisi
altta bulunan konfigürasyon paneline yansır. İstenirse
“Ayarlar” butonu ile seçili cihaz adı veya ağ ayarları
değiştirilebilir. Bu işlemler cihazı resetler.
Cihazların default IP değeri “192.168.1.200” dür. IP
adresi DHCP veya statik olarak kullanıcı tarafından
değiştirilebilir.
Aynı işlemi, cihaz listesinde istenilen cihazın
üzerinde sağ tıklama yapıldığında açılan menüden de
yapabilirsiniz.
Cihaz listesinden seçilen cihazın bağlantısında cihaz
listeleme işleminden beri bir sorun olmamışsa seçili
cihaz anında aktifleşir ve cihazın giriş/çıkış durumları
görüntülenir. Sorun oluşmuş ise giriş ve çıkış panelleri
Aktifleştirilen cihazın ilgili çıkışını ON veya OFF konumuna almak için ilgili
buton
7
EXETHIO
Expkits
Sürüm 5.02b
grubundaki ON/OFF butonlarına tıklanır. Bu butonların
durumları direkt olarak cihaz tarafından onaylanacak
şekilde tasarlanmıştır. Eğer verilen komut ağ sorunları
gibi nedenlerle başarısız olacak olursa buton durumu
değişmez.
ÜM
AN
Giriş paneli cihaz girişlerine en kısa sürede tepki
verecek şekilde programlanmıştır. Cihaz girişleri default
olarak ON ’1’ konumundadır. Bu nedenle tüm girişler
yeşil olarak görüntülenir. Cihaz giriş terminalindeki
COM ucuna 12-24V DC bağlanıp terminal girişlerin GND
uygulandığında ilgili girişlerin durumu OFF ‘0’ olarak
değişir.
Aynı anda iki adet GUI çalıştırılmamalıdır. Bu
durumda sadece ilk çalıştırılan GUI aktif olarak çalışacaktır.
DÖ
K
7. DLL ve API Kullanımı
TA
SL
AK
Cihaz ile iletişim kurarak kendi
uygulamalarınıza
entegre
edebilmenizi
sağlamak için CD içerisinde DLL API ve Örnek
Kodlar (Visual C# 2010) sunulmaktadır. Bu
DLL managed bir DLL olup yine managed
(.NET destekli tüm diller, C#, Delphi.NET v.b.)
diller ile çalışabilecek şekilde tasarlanmıştır.
Unmanaged (C, C++, Delphi 4-7, v.b.) diller
ile kullanımı sırasında bu bilgi göz önünde
bulundurulmalı ve kodlama buna göre COM
nesnesi olarak yapılmalıdır.
DLL aşağıda listesi ve açıklaması verilen
fonksiyonları barındırır. Bu fonksiyonların
kullanımına ait örnek uygulamaya ait kod listesi yine aşağıda verilmiştir. Bu örnek uygulamaya
yine CD içerisindeki “Sample Program” klasöründen ulaşabilirsiniz.
a) ETHIO() Sınıfı
DLL tarafından sağlanan temel cihaz algılama fonksiyonları ETHIO sınıfından türer. Bunun
için istenilen fonksiyonu kullanmak için öncelikle ETHIO türünden bir nesne oluşturulmalıdır.
Bir bilgisayarda aynı anda sadece bir adet ETHIO nesnesi oluşturulabilir.
private ETHIO _cihazlar=new ETHIO();
ETHIO sınıfı temel olarak FindDevices() ve ConnectDevice() olmak üzere iki adet method
8
EXETHIO
Expkits
Sürüm 5.02b
barındırmaktadır. Bu methodlardan FindDevices ağdaki tüm cihazları tarayarak ETHIO.
DeviceList sözlüğü üzerinden cihazların listesini verir.
ETHIO.FindDevices()
ETHIO.ConnectDevice(string ip)
ÜM
AN
Ağda mevcut tüm cihazları arar ve bulduklarını DeviceList sözlüğü üzerinden kullanıcıya
sunar. Dönüş değeri olarak bulunan cihaz sayısını verir. Eğer bilgisayarda birden çok ethernet
arayüzü var ise işletim sistemi tarafından sağlanan ilk arayüz üzerindeki ağı tarayacaktır. Bu
genelde internete çıktığınız ethernet arayüzüdür.
IP adresi belirtilen cihaza bağlanır ve cihazı DeviceList sözlüğüne ekler. Dönüş değeri
işlemin başarılı olup olmadığını bildirir ve ETHIO.Response tipindedir.
ETHIO.DeviceList
DÖ
K
Tespit edilen cihazların bir sözlük listesini verir. Listedeki tüm elemanlar ETHIO.Device()
sınıfındandır.
ETHIO.ResetDeviceConfig(int MACData)
AK
Bu method cihaz ağ yapılandırması hatalı yapılmışsa ve artık cihaza ulaşılamıyorsa
kullanılabilecek alternatif bir methoddur. Cihaz donanım MAC adresinin son iki hanesi
(00:04:A3:68:XX:YY ise MACData=0xXXYY) parametre olarak verilir. Kullanıcı cihazın aynı ağ
içinde olduğundan emin olmalıdır. Aksi halde ethernet paketleri cihaza ulaşamayacağından
işlem başarısız olur.
TA
SL
ETHIO.SetDeviceConfigUseMac()
MAC adresi verilen cihazın konfigürasyonunu değiştirmek için kullanılır.
ETHIO.FindDeviceMacAddress()
IP adresi verilen cihazın MAC adresini bulmak için kullanılır.
ETHIO.GetVersion()
DLL sürümünü verir.
b) Device() Sınıfı
Cihaza ait nesnedir. Bu nesne cihaz ile ilgili tüm bilgiler ve işlemlerden sorumludur. Device
9
EXETHIO
Expkits
Sürüm 5.02b
sınıfı cihazın adı, tipi, firmware sürümü, ağ bilgileri gibi bilgileri sunduğu gibi giriş/çıkışların
durumlarını kontrol etmeyi de sağlar. Bunu Device.Outputs ve Device.Inputs özellikleri ile
başarır. Kullanıcı bu alanları set ve get ederek direkt cihazın I/O hattına erişim sağlar. Bunun
dışında Device sınıfının barındırdığı Reset(), SetPin(), Ping(), SetDeviceName() ve SetConfig()
kontrol methodları vardır.
Device.SetPin(int pin, int status)
ÜM
AN
Bu method cihazın verilen pin durumunu set veya reset eder. status parametresi olarak
sadece 0 veya 1 geçerlidir. Verinin tipi gelecek güncellemeler için int olarak seçilmiştir. Bu
kullanıcıyı yanıltmamalıdır.
aktifCihaz.SetPin(8,1); // Bu satır seçilen cihazdaki 8 numaralı röleyi açar.
aktifCihaz.SetPin(8,0); // Bu satır seçilen cihazdaki 8 numaralı röleyi kapatır.
Device.Ping()
DÖ
K
Cihazın varlığını kontrol eder. Eğer Ping() methodu Response.ResOK döndürmüyorsa cihaz
bağlantısı ile ilgili bir sorun var demektir.
Device.SetDeviceName(string deviceName)
AK
Cihazın ismini değiştirmek için kullanılır. Response.ResOk döndürmüyorsa işlemde sorun
var demektir. Bu komut kullanıldıktan sonra cihaz geri bildirim yapıp kendini resetler.
Device.SetConfig (DeviceInfo config, bool forceProceed)
TA
SL
Cihazın mevcut ağ yapılandırmasını değiştirmek için kullanılır. Kullanıcı yeni konfigürasyon
bilgisini tam ve doğru biçimde DeviceInfo tipinde sağlamalıdır. Eğer IsDhcp bayrağı true ise ip
konfigürasyonu cihaza yazılmaz. Yanlış ağ yapılandırması cihazı ulaşılamaz hale sokacaktır.
Bu işlem başarılı ise Response.ResOk döner ve cihaz kendini resetler.
Device.Reset()
Cihazı yeniden başlatır. Cihaz kendini resetlemeden önce komutun başarılı olduğuna dair
Response.ResOk olarak bildirim yapar.
8. Notlar
Cihazın kullanımıyla ilgili daha detaylı bilgi için verilen örnek uygulama kodlarına
bakabilirsiniz. Bu döküman cihazın kullanımına ilişkin temel bilgiler içeren bir taslaktır.
Cihazı bilgisayar dışında bir kontrol ünitesinden kontrol etmek için lütfen bizimle irtibata
10
EXETHIO
Expkits
Sürüm 5.02b
geçiniz.
EXPKITS;
Cihaz, DLL API, Kullanım Klavuzu ve Firmware üzerinde son kullanıcıya bildirimde
bulunmaksızın değişiklik yapma hakkını saklı tutar. Kullanıcılar güncelleştirmeleri takip
etmek sorumluluğundadırlar.
ÜM
AN
Firmware versiyonları ve güncellemeleri için bizimle irtibata geçiniz
TA
SL
AK
DÖ
K
e-mail: [email protected]
11

EXETHIO Kullanım Klavuzu R5.02b

Transkript

Benzer belgeler

Teknik Özellikleri : (Expel Home-F Ultrasonic Fare Savar Teknik

Homojenizatör – “Hafif Yük” Teknik Şartnamesi 1. Cihaz genel

şarjlı ampul

RS-422/RS-485 Binary Mifare Modül okuyuculu : direkt

Kullanım Kılavuzu

otoklav kullanım talimatı

Goldspeed EVO S1 / S1-L / M5-L / D1 / D1-L / R20-L / E16

teknik şartname

T.C. UŞAK ÜNİVERSİTESİ İDARİ VE MALİ İŞLER DAİRE