Description of Commands for Communication with the power supply via the Serial Port

https//www.racom.eu/eng/products/m/msu120/apa.html

Appendix A. Description of Commands for Communication with the power supply via the Serial Port
Prev		Next

Print version

Appendix A. Description of Commands for Communication with the power supply via the Serial Port

The MSU120 solar power supply is fitted with an RS232 serial port allowing basic control and set up during manufacture and installation. Communication takes place at 19200 Bd, 8, n, 1. The power supply reacts to single-character (ASCII) commands, and the reply from the power supply is in the form of text strings (mostly ending in CR/LF). It is possible to communicate with the power supply in this way even after connecting it to a common terminal. For remote access to the power supply in the MORSE network the program SOLTERM (Win-application) is available.

Description of certain commands

[command]

Command description

<response>

[i]

ID source + firmware version

<|S/N:001>
<|SOL28 (2005-06-27)>

[t]

current time

<2004-12-11*02:34:59>

[m]

Displays the header of the printout of measured values

<|Ub     Ib      Us    Is    Ismax  Pwr   Tep>

[a]

Printout of measured values – battery voltage, battery current, solar panel input voltage, current from solar panel, max. measured current from the previous minute, current delivered power, temperature…

<|11.6  -0.4    16.2    0.7    0.7    8    41>

[a]

<|11.6  -0.4    16.2    0.7    0.7    8    41>

[b]

Same values in binary internal values

[ENTER]

Switches power supply to state of readiness for receiving a multicharacter command

<Ready – waiting…>

– If another command is not received within 2 seconds the power supply reports a Timeout

<TimeOut>

[d + time]

For setting the power supply´s internal time in format : [d2005-08-31*21:54:06] it sends the current time to the power supply (necessary directly after pressing ENTER)

<Date OK 2005-08-31 21:54:06>

(Program SOLTERM automatically sends the current time after pressing [d])

[f]

Switches the source to the solar panel full power mode

<Full Power Mode ON/OFF>

[v]

Switches the source to/from the Verbose mode

<Verbose Mode ON/OFF>

In this mode the power supply reports:

disconnection of battery from output (approx. 1 minute before disconnection)
```
<|Battery Low->Switch output OFF! Ubat=10.7 2004-12-12*20:19:59
```
when connecting the battery to the output (approx. 20 seconds after connection)
```
<|Output ON Ubat=12.0  2004-12-12*20:19:59
```
transition to sleep mode (Ubat < 10 V, or USol < Ubat in SLEEP MODE )
```
<|Sleep  Ubat=9.9  2004-12-12*23:19:59
```
transition from sleep mode ( USol>Ubat) or the moment the battery is connected to the output (Ubat>12V)
```
<|Wake-Up  Ubat=10.1  2004-12-13*08:19:59
```

on the turn of a new day – total for the previous day

<
|S/N:001        
|Day status:2004-12-10*00:00:00
|Battery Voltage max.(V):11.9     at 14:58
|Battery Voltage min.(V):10.7     at 05:41
|Max. charge current (A):2.8      at 11:43
|Max. Solar current (A):3.5       at 11:44
|Total charge  (Ah):8.7
|Total dischg. (Ah):11.9
|Actual dischg (Ah):8.0
|Solar energy used (Ah):15.6
|Solar energy poss.(Ah):15.6
|Temperature max. (^C):46
|Temperature min. (^C):22
|Last Out-ON  12-31*23:59 
|Last Out-OFF 08-09*07:22
>

[s]

sends the current sum from the beginning of the day

<
|S/N:001        
|Day status:2005-08-09*15:24:39
..
..
|Last Out-OFF 08-09*07:22
>

[y]

sends the stored sum from the previous day

|Day status:08-08
|Battery Voltage max.(V):11.9     at 14:58
..
..
|Last Out-OFF 08-09*07:22
>

[N]

sends the 1st block of the measured values record from the previous day

<
t    005    008    009    000    000    000    060
D    130    000    027    000    004    152    000
D    130    000    027    000    004    152    000
…
…
D    130    000    027    000    004    152    000
D    130    000    027    000    004    152    000        000
>

– the last figure represents the block number

[n]

Sends another block of the measured values record the previous day. The meaning of values in individual columns is as follows:

row representing the date and time of the beginning of the daily record (the last value determines the period of the record of measured values in seconds = 60 s)

row with recorded data (all values represent internal values of the power supply without conversion to real values ):

UBat	battery voltage
IBat+	positive battery current
IBat-	negative battery current
USol	voltage on the solar panel terminals
ISol	current from the solar panel
UTermExt	temperature of external temperature sensor
ISolMax	maximum current that can be drawn from the solar panel (test at max. current)

[L]

sends the first block of the daily sums record

<
s 031 012 127 014 114 023 059 012 023 028 014 008 026 025 075
..
..
s 013 003 125 012 089 010 052 011 023 024 008 007 020 019 075
s 014 003 128 013 087 008 048 013 022 025 022 001 042 041 074
s 015 003 136 014 120 007 060 011 021 025 029 000 032 031 073
s 016 003 144 013 126 006 052 013 020 024 022 000 024 024 057
s 017 003 147 010 129 007 048 012 023 026 022 000 024 025 062
s 018 003 147 011 129 007 040 011 023 026 015 000 017 021 062
s 019 003 147 012 128 006 025 013 022 024 013 000 015 017 066  096
>

– the last figure represents the block number

[l]

sends the next block of the daily sums record. The meaning of values in individual columns is as follows:

SumHdr	“s” header for field of stored values
SumDay	day record made/sumday
SumMonth	month
DmaxUBat	max. battery voltage during the day [0.1 V]
TmaxUbH	time of record/write time of max. voltage [hours]
DminUBat	min. battery voltage during the day [0.1 V]
TminUbH	time of record/write time [hours]
DMaxIBat	max. recorded value of current Ibat [0.1 A]
TmaxIbH	time of record/write time [hours]
DmaxUThext	max. temperature [ºC]
DminUThext	min. temperature [ºC]
DSIBatP	energy supplied to the battery [Ah]
DSIBatM	energy drawn from the battery [Ah]
DSISol	energy drawn from the solar panel [Ah]
DISolMax	max. energy that can be taken from the solar panel [Ah]
DmaxISol	highest daily value of current from the solar panel [0.1 A]

[r]

repeats transmission of the last sent block of the daily sums record or measured values record from the previous day

[w]

MSU120 sends a 1 byte status with the following meaning:

Bit 0 _BatLL	Lowe battery voltage (Ubat < 10 V) – transition to SLEEP mode
Bit 1 _BatteryLow	Low battery voltage UBat < 11.5 V
Bit 2 _BatOff	indication of disconnected output
Bit 3 _USolOK	Sufficient voltage USol ( = USol > UBat)
Bit 4 _NegIb	Negative current to the battery = discharging
Bit 5 _GoVyp	Notified switching off = disconnection of the battery from the output DC-OUT of the power supply
Bit 6 _Foc	running phase of overcharge charging
Bit 7 _Ffl	running phase of float charging

[g]

switches the source to automatic sleep mode if there is a lack of solar energy

<SLEEP Mode ON/OFF>

– in this mode the actual consumption of the power supply is reduced, transition back to full operation is automatic upon reaching a sufficient voltage from the solar panel

Prev		Next
8. Conditions for MSU120	Contents	Appendix B. Temperature curve of sensor KTY10