UVCAN

uvcan on työkalu, jolla Usevoltin ohjausjärjestelmän laitteet otetaan käyttöön ja pidetään kunnossa. Se yhdistetään koneeseen CAN-väylän kautta, ja sillä hoituvat kaikki ne työt, joita laitteen asennus ja huolto vaativat: laiteohjelmiston päivitys, parametrien luku ja kirjoitus, väyläliikenteen seuranta ja vianetsintä.

uvcan on tarkoitettu asentajille, huoltajille ja konevalmistajille. Se ei ole koneen kuljettajan työkalu – kuljettaja käyttää konetta UV0D-kosketusnäytön kautta.

Mitä sillä tehdään

• Laiteohjelmiston päivitys. Uusi ohjelmisto ladataan laitteeseen CAN-väylää pitkin, ilman erillistä ohjelmointilaitetta.
• Parametrien säätö. Laitteen asetukset luetaan, muutetaan ja tallennetaan. Koko koneen asetukset voidaan tallentaa tiedostoon ja ladata takaisin tai toiseen samanlaiseen koneeseen.
• Väylän seuranta ja vianetsintä. CAN-liikenne, laitteiden tila ja virheilmoitukset näkyvät suoraan ohjelmassa.
• Simulaattori. Laitepaketin mukana tuleva simulaattori ajaa saman ohjelmiston tietokoneella, joten asetuksia voi kokeilla ilman konetta.
• Graafinen käyttöliittymä. Komento uvcan --ui avaa ikkunan, jossa koko järjestelmä laitteineen näkyy kerralla. Kaikki toiminnot ovat myös komentoriviltä.

Laitepaketit (.uvdev) ja järjestelmätiedostot (.uvsys) aukeavat asennuksen jälkeen kaksoisnapsautuksella suoraan uvcaniin.

Lataus ja asennus

Linux

Avaa pääte ja anna komento:

curl -fsSL https://files.usevolt.fi/pub/uvcan/get-uvcan.sh | sh

Komento hakee uusimman version, tarkistaa latauksen tarkistussumman, asentaa ohjelman kotihakemistoon ja rekisteröi .uvdev– ja .uvsys-tiedostot. Pääkäyttäjän oikeuksia ei tarvita. Koko koneelle asennetaan lisäämällä komennon perään -s -- --system.

Windows

Avaa PowerShell ja anna komento:

irm https://files.usevolt.fi/pub/uvcan/get-uvcan.ps1 | iex

Sama komento sekä asentaa ohjelman että päivittää sen. Ohjelma asentuu oletuksena kansioon %LOCALAPPDATA%\Usevolt\uvcan, joten ylläpitäjän oikeuksia ei tarvita. Asennuksen jälkeen uvcan-ui.bat avaa käyttöliittymän ja install-association.bat rekisteröi laitepakettien tiedostotyypit.

Päivittäminen

uvcan tarkistaa käyttöliittymän käynnistyessä, onko uudempi versio julkaistu, ja kertoo siitä lokinäkymässä. Tarkistuksen voi tehdä myös itse:

uvcan --checkupdate

Linuxissa ohjelma päivittää itse itsensä:

uvcan --update

Päivitys tarkistetaan julkaistua tarkistussummaa vasten ennen kuin mitään korvataan, ja edellinen versio jää talteen nimellä uvcan.old. Jos uvcan on asennettu koko koneelle, päivitys vaatii sudo uvcan --update.

Windowsissa päivitys tehdään ajamalla sama asennuskomento uudelleen. Se vertaa asennettua versiota julkaistuun eikä lataa mitään, jos kone on jo ajan tasalla.

Poistaminen

Linux

curl -fsSL https://files.usevolt.fi/pub/uvcan/uninstall-uvcan.sh | sh

Komento poistaa ohjelman, tiedostotyyppien rekisteröinnit ja kuvakkeet sekä asennuksen tekemän PATH-lisäyksen. Se löytää sekä käyttäjäkohtaisen että koko koneen asennuksen. Omat .uvdev– ja .uvsys-tiedostot eivät katoa, eivätkä tallennetut tilitiedot — ne poistetaan lisäämällä komennon perään -s -- --purge.

Windows

irm https://files.usevolt.fi/pub/uvcan/uninstall-uvcan.ps1 | iex

Komento poistaa asennuskansion, tiedostotyyppien rekisteröinnit ja PATH-lisäyksen. Se ei koske tiedostotyyppiin, jonka jokin muu ohjelma on sittemmin ottanut käyttöönsä, eikä käynnisty lainkaan jos uvcan on auki.

Vaatimukset

Linux	Ubuntu tai muu Debian-pohjainen jakelu. Asennuskomento hakee tarvittavat kirjastot apt:lla.
Windows	Windows 10 (versio 1803) tai uudempi.
CAN-liitäntä	Linuxissa mikä tahansa SocketCAN-yhteensopiva sovitin. Windowsissa PEAK PCAN-USB, jonka ajuri asennetaan erikseen valmistajan sivuilta.

Kaikki versiot

Asennuskomennot hakevat aina uusimman julkaistun version. Kaikki julkaistut tiedostot ovat vapaasti selattavissa:

Lisenssi

uvcan on vapaa ohjelmisto. Sen lisenssi on GNU General Public License, versio 3, ja lisenssiteksti tulee ohjelman mukana. Ohjelmaa saa vapaasti käyttää, kopioida ja muokata; muokattua versiota levitettäessä myös lähdekoodi on luovutettava samoin ehdoin.