//    This file is part of SWINT1 - Small
//    Wind Turbine controller software type 1.
//    Made for one of the first JBA turbines,
//    in remembrance of Jan Andersson, the
//    turbine designer who left us much too
//    early.
//
//    Copyright (C) 2021-2024  TEROC AB.
//
//    SWINT1 is free software: you can
//    redistribute it and/or modify it under the
//    terms of the GNU General Public License
//    as published by the Free Software
//    Foundation, either version 3 of the
//    license, or (at your option) any later
//    version.
//
//    SWINT1 is distributed in the hope that it will
//    be useful, but WITHOUT ANY
//    WARRANTY; without even the implied
//    warranty of MERCHANTABILITY or
//    FITNESS FOR A PARTICULAR
//    PURPOSE.  See the GNU General Public
//    License for more details.
//
//    You should have received a copy of the
//    GNU General Public License along with
//    SWINT1.  If not, see
//    <http://www.gnu.org/licenses/>.
//
//    Note that SWINT1 depends on other
//    software, with different licensing
//    conditions.
//
//    We are thankful to Wago, Stefan
//    Eriksson and others, who have
//    provided helpful examples and support.
//
//    For more information, contact Sven Ruin,
//    sven.ruin@teroc.se


ALLMNT

SWINT1 r ett minimalistiskt styrsystem fr sm vindkraftverk. Det har provats ut p ett av de tidiga JBA-15 
(15 kW mrkeffekt). Bakgrunden r att den tidigare PLCn dr, som var gammal och fr lnge sedan programmerats 
av ngon annan, hade gtt snder. TEROC tog d fram en ny lsning baserad p Wago, som fungerar mycket bra i 
praktisk drift. Teknisk dokumentation till JBA-verken har slppts under CreativeCommons-licens, se 
https://jbavind.se/jba-gardsverk/. Sammantaget finns allts det mesta som behvs fr att underhlla JBA-
verk, eller bygga nya, tillgngligt som "ppen kllkod".

Hrdvara som frberetts med mjukvara sljs av TEROC, som ocks kan erbjuda utbildning, support etc som 
konsulttjnster.

Styrsystemet kan enkelt fjrrvervakas och fjrruppdateras p distans med tillgg frn TEROC.

Vindkraftverket frutstts bland annat ha "stall"-reglering (bladen verstegras passivt vid hg vindhastighet), 
en asynkrongenerator med nominellt varvtal 1500 varv/minut, aktivt girsystem och en tillfrlitlig skivbroms p 
huvudaxeln.

Dessutom frutstts PLCn kompletteras av:
- ett skyddsrel, fr att vervaka funktionen p elntet (vi har anvnt Ziehl UFR1001E, som stllts in rtt)
- en elmtare av typen Shelly Pro 3EM, som bland annat vervakar fasfljden och kommunicerar via Modbus TCP

PLCn fungerar dock utan elmtare. Det r oskert om den version vi anvnt av Shelly Pro 3EM mter rtt vad 
gller effekt och energi frn vindkraftverket.

SWINT1 version 1.0 skapades med CoDeSys ver 2.3.9.49 (Wago-I/O-Pro), p en separat dator. Du kommer behva 
CoDeSys fr att redigera styrprogrammet. Ett stt att ansluta till PLCn r att anvnda en service-kabel 750-923, 
som behver en drivrutin.

Fljande bibliotek fr CoDeSys 2.3 anvnds (vissa av dem kan leveraras med CoDeSys och vissa ska vara mjliga 
att ladda ner frn Wago):
Ethernet.lib (29.6.15)
ModbusEthernet_04.lib (10.7.18)
mod_com.lib (23.8.18)
Wago_MBCFG_ETHERNET16_01.lib (10.7.18)
Wago_MBCFG_COMMON_01.lib (10.7.18)
Standard.lib (29.6.15)
SYSLIBCALLBACK.LIB (29.6.15)

(Baserat p SWINT1 utvecklar vi ven SWINT2, fr ett av de senare JBA-verken som har fler funktioner.)


HRDVARA PLC

1 st 750-862
1 st 750-638
1 st 750-430
2 st 750-515
1 st 750-600


INGNGAR TILL PLC

Beteckning  Variabel                Kommentar
2.1         uGenSpeedPulseCounter   4 pulser per varv
2.5         uWindSpeedPulseCounter  10 pulser per m/s
3.1         xWindDir0
3.5         xTempGen
3.2         xTempGearbox
3.6         xOverspeedGuard
3.3         xVibrationGuard
3.7         xProtectionRelay        Frn skyddsrel
3.4         xStopButton


UTGNGAR FRN PLC

Beteckning  Variabel
4.5         xBrakeRelease
4.6         xBrakeMagnet
4.7         xGen
4.8         xYawCW
5.5         xYawCCW


STATUSKODER

uStatusCode:
1 = bromsmagneten har ftt order att dra (allt ok)
2 = vindhastigheten tillrcklig (minst 2,5 m/s i ca 2 min) fr normal girning
4 = generator inkopplad
16 = vindhastighet mycket lg, kabeln kan komma att tvinnas upp
32 = "untwist 1" (girar medurs fr att tvinna upp kabel)
64 = "untwist 2" (girar moturs fr att tvinna upp kabel)
128 = hg vindhastighet
512 = "slow stop"
1024 = "fast stop"


FELKODER

uErrCode:
1 = kommunikationsfel med elmtare
2 = varning skyddsrel har lst ut eller felaktig fasfljd
4 = varning temperatur generator
8 = varning temperatur vxellda
16 = larm hg generatorhastighet
32 = larm hg turbinhastighet, inte infrt
64 = larm givarkontroll 1 = ingen generatorhastighet medan generator r ansluten
128 = larm givarkontroll 2 = generatorhastighet jmfrt med turbinhastighet, inte infrt
256 = varning givarkontroll 3 = lg vindhastighet medan generator r inkopplad
512 = larm timeout girning (140 s)
1024 = larm felaktig fasfljd frn elmtare
2048 = larm vervarvsvakt har lst ut
4096 = larm vibrationsvakt har lst ut
8192 = larm stoppknapp
16384 = larm fr upprepad varning
