Programvara

Allmänt

Den programvara som används till Wisp628 består av två delar :

• En del som körs i den PIC16F628A som sitter på Wisp628'an ("firmware").
• En del som körs i den PC som Wisp628 är ansluten till.

Programvara för Wisp628 (firmware).

Den PIC16F628A som levereras med satsen är förprogrammerad med senaste version av firmware.

VOTI kommer ibland med uppdateringar, och de kan då hämtas ner kostnadsfritt som en HEX fil från www.voti.nl.

Sedan behöver man bara en extra PIC16F628A för själva bytet.

Man använder alltså en extra PIC16F628A att programmera in den nya programvaran i. Sedan stänger man av allting och byter ut PIC:arna. Den gamla 628:an kan man nu spara till nästa uppgradering. Vill man inte skaffa en extra PIC bara för detta behov, kan JESCAB erbjuda ett utbyte mot en mindre hanteringskostnad.

Programvara för PC:n.

En Wisp628 behöver en lämplig programvara på PC:n att "snacka" med. Det finns två alternativ :

• Original programvaran från VOTI kallad XWisp.
• En "kopia" av XWisp kallad XWisp2w.

XWisp är utvecklad i ett "scriptspråk" som heter Python. Problemet med detta är att man måste ladda ner ett par stora "run-time" moduler och installera. Flera tusen filer som installeras, enbart för att köra XWisp.

XWisp2w är däremot helt skriven i "C" och det är enbart två filer som behöver installeras, en EXE och en CFG fil. XWisp2w är tillgängligt från killen som har utvecklad den, http://www.robh.nl/. Där kan man hitta två kit för nedladdning, det mindre har enbart det man behöver för att köra, det andra innehåller även källkod.

JESCAB rekommenderar XWisp2w p.g.a av den betydligt enklare installationen. Beskrivningen nedan förutsäter att XWisp2w används. För den som ändå vill använda original XWisp, finns kit för nerladdning samt instruktioner på VOTI's hemsida här.

Notera att i ZIP filen från "robh" finns det även en fil som heter xwisp2.exe (utan extra "w"), den är inte för Windows !

Notera !!!

Den just nu sensaste verison (1.12) har problem med 16F87xA serien. D.v.s 887A o.s.v. För dessa kretsar använd version 1.11 som också finns för nedladdning från www.robh.nl.

Notera ! För den nya 16F88x serien måste en fil i XWISP2 bytas ut, det är "xwisp2_14.cfg". Ladda ner den nya filen här. Det är en ZIP fil som innehåller den uppdaterade filen med stöd för 16F88x serien. Ersätt den xwisp2_14.cfg som kom tillsammans med XWISP2 kittet. Nästa version av XWISP2 (1.13 ?) kommer att ha dessa kretsar med från början.

Installation av XWisp2w

XWisp2w har inget speciellt installtionsverktyg, men det är bara ett par filer att kopiera, så man gör det enkelt "för hand".

• Ladda ner kittet (det mindre antagligen) från robh.nl, packa upp EXE och CFG filen.
• Flytta/kopiera EXE och CFG filen till en katalog som finns i maskinen "PATH". Enklast är att helt enkelt kopiera dom till Windows katalogen ("C:\WINDOWS" eller "C:\WINNT" beroende på Windows version).

Användningen av XWisp2w

XWisp2w är inte integrerat i MPLAB, utan körs separat med en HEX fil som infil. HEX filen kan vara skapad av MPLAB, med något annat utvecklingsverktyg eller kanske vara nerladdad från nätet.

XWisp2w har ett "kommandorads" gränssnitt. Man öppnar ett commando fönster (välj "Run" i start-menyn. Sedan antingen "command" eller "cmd"), nu skall ett kommando fönster öppnas med en dos-prompt.

Här nedan följer några exempel på användning av XWisp2w. Exemplen är med en PIC18F254 ansluten och med ett av test programmen från http://www.voti.nl/blink/index.html.

Utan parametrar

Om XWisp2w körs utan parametrar får man en rad med bl.a versions nummer ("1.5.03" i exemplet nedan) samt några sidor med bl.a hjälptexter och en lista med PIC modeller som för tillfället stöds. (ej med i exemplet).

C:\DATA\Xwisp2\test>xwisp2w
 XWisp2 version 1.5.03 (Sep 06 2004, Open Watcom C 1.30)

Med ett felaktigt filnamn

Om man kör XWisp2w med ett felaktigt filnamn får man följande :

C:\DATA\Xwisp2\test>xwisp2w go b452-3
 XWisp2 version 1.5.03 (Sep 06 2004, Open Watcom C 1.30)
Could not open input file B452-3.Hex
XWisp2 failed after 0.06 seconds, rc 23!

(Det finns ingen fil som heter B452-3.HEX !)

Med ett korrekt filnamn, men med fel COM-port.

Om man inte anger vilken COM-port Wisp628 är ansluten till, används port 1 (COM1), vilket i exemplet var fel.

C:\DATA\Xwisp2\test>xwisp2w go b452-1
 XWisp2 version 1.5.03 (Sep 06 2004, Open Watcom C 1.30)
File B452-1.Hex loaded and Intel Hex format conforming
Total of program and data memory: 112 bytes
SendReceiveSlow read timeout
Failed to activate Wbus device
XWisp2 failed after 0.03 seconds, rc 23!

I detta fall är Wisp628 ansluten via en USB/RS232 converter, och den sitter på port 5 (COM5).

I nästa exempel anges "port 5" som parameter till XWisp2w, och då går det bättre...

Filnamn och COM-port korrekt, men Wisp628 ansluten felaktigt.

I detta fall är inkopplingen av Wisp628 rätt gjord till PC'n, XWisp2w får kontakt med Wisp628 (med firmware 1.09 i exemplet), men det finns ingen korrekt ansluten PIC till Wisp628'an.

C:\DATA\Xwisp2\test>xwisp2w port 5 go b452-1
 XWisp2 version 1.5.03 (Sep 06 2004, Open Watcom C 1.30)
File B452-1.Hex loaded and Intel Hex format conforming
Total of program and data memory: 112 bytes
Programmer Wisp628, firmware version 1.09
Target not found in configuration table
Target not auto-detected, please specify on commandline!
XWisp2 failed after 1.22 seconds, rc 23!

Till sist ett exempel på hur det ser ut när allt är OK !

Alltså :

- Wisp628 rätt ansluten till PC'n.

- Rätt port angiven i XWisp2w kommandot.

- En HEX fil är angiven som existerar.

- En PIC är anslutn till Wisp628 som känns igen av XWisp2w.

Programeringen gick bra ("OK" på alla rader.

C:\DATA\Xwisp2\test>xwisp2w port 5 go b452-1
 XWisp2 version 1.5.03 (Sep 06 2004, Open Watcom C 1.30)
File B452-1.Hex loaded and Intel Hex format conforming
Total of program and data memory: 112 bytes
Programmer Wisp628, firmware version 1.09
Detected target: 18F452 revision 06 (ID=0426)
Target erased
Transferring image to 18F452 via Wisp628
Transferring program memory...OK!
Verifying program memory......OK!
Transferring data memory......OK!
Verifying data memory.........OK!
Transferring ID memory........OK!
Verifying ID memory...........OK!
Transferring fuses memory.....OK!
Verifying fuses memory........OK!
Write-Verify terminated successfully in 0.55 seconds
Putting target in run mode
XWisp2 terminated successfully in 1.96 seconds