Wiki source code of WSC1-L-Dragino LoRaWAN Weather Station User Manual

Version 105.15 by Xiaoling on 2023/06/16 09:06

version	line-number	content
104.10	1	(% style="text-align:center" %)
	2	[[image:1656035424980-692.png\|\|height="533" width="386"]]
1.1	3
	4
	5
3.11	6	Table of Contents:
1.1	7
104.10	8	{{toc/}}
1.1	9
	10
	11
	12
	13
	14
	15
	16
	17
2.3	18	= 1. Introduction =
1.1	19
2.3	20	== 1.1 Overview ==
1.1	21
2.3	22
3.13	23	(((
	24	Dragino LoRaWAN weather station series products are designed for measuring atmospheric conditions to provide information for weather forecasts and to study the (% style="color:#4472c4" %)weather and climate(%%). They consist of a (% style="color:#4472c4" %)main process device (WSC1-L) and various sensors.
	25	)))
2.2	26
3.13	27	(((
3.11	28	The sensors include various type such as: (% style="color:#4472c4" %)Rain Gauge, Temperature/Humidity/Pressure sensor, Wind Speed/direction sensor, Illumination sensor, CO2 sensor, Rain/Snow sensor, PM2.5/10 sensor, PAR(Photosynthetically Available Radiation) sensor, Total Solar Radiation sensor(%%) and so on.
3.13	29	)))
2.2	30
3.13	31	(((
	32	Main process device WSC1-L is an outdoor LoRaWAN RS485 end node. It is powered by external (% style="color:#4472c4" %)12v solar power(%%) and have a (% style="color:#4472c4" %)built-in li-on backup battery(%%). WSC1-L reads value from various sensors and upload these sensor data to IoT server via LoRaWAN wireless protocol.
	33	)))
2.2	34
3.13	35	(((
3.11	36	WSC1-L is full compatible with(% style="color:#4472c4" %) LoRaWAN Class C protocol(%%), it can work with standard LoRaWAN gateway.
3.13	37	)))
2.2	38
	39
2.3	40	= 2. How to use =
2.2	41
2.3	42	== 2.1 Installation ==
	43
91.13	44
4.2	45	Below is an installation example for the weather station. Field installation example can be found at [[Appendix I: Field Installation Photo.>>\|\|anchor="H11.AppendixI:FieldInstallationPhoto"]]
2.2	46
91.13	47
104.10	48	[[image:1656041948552-849.png]]
2.2	49
4.3	50
3.11	51	(% style="color:blue" %) Wiring:
2.2	52
	53	~1. WSC1-L and sensors all powered by solar power via MPPT
	54
	55	2. WSC1-L and sensors connect to each other via RS485/Modbus.
	56
	57	3. WSC1-L read value from each sensor and send uplink via LoRaWAN
	58
	59
	60	WSC1-L is shipped with a RS485 converter board, for the easy connection to different sensors and WSC1-L. Below is a connection photo:
	61
91.13	62
104.10	63	[[image:1656042136605-251.png]]
2.2	64
	65
79.2	66	(% style="color:red" %)Notice 1:
2.2	67
	68	* All weather sensors and WSC1-L are powered by MPPT solar recharge controller. MPPT is connected to solar panel and storage battery.
	69	* WSC1-L has an extra 1000mAh back up battery. So it can work even solar panel and storage battery Fails.
91.13	70	* Weather sensors won't work if solar panel and storage battery fails.
2.2	71
79.2	72	(% style="color:red" %)Notice 2:
	73
2.2	74	Due to shipment and importation limitation, user is better to purchase below parts locally:
	75
	76	* Solar Panel
	77	* Storage Battery
	78	* MPPT Solar Recharger
91.2	79	* Mounting Kit includes pole and mast assembly. Each weather sensor has it's own mounting assembly, user can check the sensor section in this manual.
2.2	80	* Cabinet.
	81
2.3	82	== 2.2 How it works? ==
	83
91.13	84
14.8	85	(((
2.2	86	Each WSC1-L is shipped with a worldwide unique set of OTAA keys. To use WSC1-L in a LoRaWAN network, user needs to input the OTAA keys in LoRaWAN network server. After finish installation as above. Create WSC1-L in your LoRaWAN server and Power on WSC1-L , it can join the LoRaWAN network and start to transmit sensor data. The default period for each uplink is 20 minutes.
14.8	87	)))
2.2	88
	89
79.4	90	(((
2.2	91	Open WSC1-L and put the yellow jumper as below position to power on WSC1-L.
79.4	92	)))
2.2	93
104.10	94	[[image:1656042192857-709.png]]
2.2	95
	96
6.4	97	(% style="color:red" %)Notice:
2.2	98
	99	1. WSC1-L will auto scan available weather sensors when power on or reboot.
91.3	100	1. User can send a [[downlink command>>\|\|anchor="H3.ConfigureWSC1-LviaATCommandorLoRaWANDownlink"]] to WSC1-L to do a re-scan on the available sensors.
2.2	101
2.3	102	== 2.3 Example to use for LoRaWAN network ==
2.2	103
91.13	104
2.2	105	This section shows an example for how to join the TTN V3 LoRaWAN IoT server. Usages with other LoRaWAN IoT servers are of similar procedure.
	106
	107
104.10	108	[[image:1656042612899-422.png]]
2.2	109
	110
	111
	112	Assume the DLOS8 is already set to connect to [[TTN V3 network >>url:https://eu1.cloud.thethings.network/]]. We need to add the WSC1-L device in TTN V3:
	113
	114
3.2	115	(% style="color:blue" %)Step 1(%%): Create a device in TTN V3 with the OTAA keys from WSC1-L.
2.2	116
	117	Each WSC1-L is shipped with a sticker with the default device EUI as below:
	118
104.10	119	[[image:image-20230426084533-1.png\|\|height="231" width="497"]]
2.2	120
	121
	122	User can enter these keys in the LoRaWAN Server portal. Below is TTN V3 screen shot:
	123
95.1	124	Put a Jumper on JP2 to power on the device. ( The Jumper must be in FLASH position).
	125
104.10	126	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSE01-LoRaWAN%20Soil%20Moisture%20%26%20EC%20Sensor%20User%20Manual/WebHome/image-20220606163915-7.png?rev=1.1\|\|alt="image-20220606163915-7.png"]]
95.1	127
12.2	128	Add APP EUI in the application.
2.2	129
104.10	130	[[image:1656042662694-311.png]]
2.2	131
104.10	132	[[image:1656042673910-429.png]]
2.2	133
	134
	135
	136
12.2	137	Choose Manually to add WSC1-L
2.2	138
104.10	139	[[image:1656042695755-103.png]]
2.2	140
	141
	142
12.2	143	Add APP KEY and DEV EUI
2.2	144
104.10	145	[[image:1656042723199-746.png]]
2.2	146
	147
	148
79.5	149	(((
3.2	150	(% style="color:blue" %)Step 2(%%): Power on WSC1-L, it will start to join TTN server. After join success, it will start to upload sensor data to TTN V3 and user can see in the panel.
79.5	151	)))
2.2	152
	153
104.10	154	[[image:1656042745346-283.png]]
2.2	155
2.3	156	== 2.4 Uplink Payload ==
2.2	157
91.13	158
2.2	159	Uplink payloads include two types: Valid Sensor Value and other status / control command.
	160
	161	* Valid Sensor Value: Use FPORT=2
	162	* Other control command: Use FPORT other than 2.
	163
6.4	164	=== 2.4.1 Uplink FPORT~=5, Device Status ===
6.3	165
91.13	166
2.2	167	Uplink the device configures with FPORT=5. Once WSC1-L Joined the network, it will uplink this message to the server. After first uplink, WSC1-L will uplink Device Status every 12 hours
	168
	169
16.5	170	(((
91.13	171	User can also use downlink command(0x2301) to ask WSC1-L to resend this uplink
16.5	172	)))
2.2	173
105.6	174	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
99.2	175	\|=(% style="width: 70px;background-color:#D9E2F3" %)Size(bytes)\|=(% style="width: 60px;background-color:#D9E2F3" %)1\|=(% style="width: 80px;background-color:#D9E2F3" %)2\|=(% style="width: 80px;background-color:#D9E2F3" %)1\|=(% style="width: 60px;background-color:#D9E2F3" %)1\|=(% style="width: 50px;background-color:#D9E2F3" %)2\|=(% style="width: 100px;background-color:#D9E2F3" %)3
13.4	176	\|(% style="width:99px" %)Value\|(% style="width:112px" %)[[Sensor Model>>\|\|anchor="HSensorModel:"]]\|(% style="width:135px" %)[[Firmware Version>>\|\|anchor="HFirmwareVersion:"]]\|(% style="width:126px" %)[[Frequency Band>>\|\|anchor="HFrequencyBand:"]]\|(% style="width:85px" %)[[Sub-band>>\|\|anchor="HSub-Band:"]]\|(% style="width:46px" %)[[BAT>>\|\|anchor="HBAT:"]]\|(% style="width:166px" %)[[Weather Sensor Types>>\|\|anchor="HWeatherSensorTypes:"]]
2.2	177
104.10	178	[[image:1656043061044-343.png]]
2.2	179
	180
104.10	181	Example Payload (FPort=5): [[image:image-20220624101005-1.png]]
2.2	182
	183
3.11	184	==== (% style="color:#037691" %)Sensor Model:(%%) ====
2.2	185
3.2	186	For WSC1-L, this value is 0x0D.
2.2	187
	188
3.11	189	==== (% style="color:#037691" %)Firmware Version:(%%) ====
2.2	190
3.2	191	0x0100, Means: v1.0.0 version.
2.2	192
3.2	193
3.11	194	==== (% style="color:#037691" %)Frequency Band:(%%) ====
3.2	195
105.6	196	0x01: EU868
2.2	197
105.6	198	0x02: US915
2.2	199
105.6	200	0x03: IN865
2.2	201
105.6	202	0x04: AU915
2.2	203
105.6	204	0x05: KZ865
2.2	205
105.6	206	0x06: RU864
2.2	207
105.6	208	0x07: AS923
2.2	209
105.6	210	0x08: AS923-1
2.2	211
105.6	212	0x09: AS923-2
2.2	213
105.6	214	0x0a: AS923-3
2.2	215
	216
3.11	217	==== (% style="color:#037691" %)Sub-Band:(%%) ====
2.2	218
3.2	219	value 0x00 ~~ 0x08(only for CN470, AU915,US915. Others are0x00)
2.2	220
	221
3.11	222	==== (% style="color:#037691" %)BAT:(%%) ====
3.2	223
79.6	224	(((
3.2	225	shows the battery voltage for WSC1-L MCU.
79.6	226	)))
3.2	227
79.6	228	(((
2.2	229	Ex1: 0x0BD6/1000 = 3.03 V
79.6	230	)))
2.2	231
	232
3.11	233	==== (% style="color:#037691" %)Weather Sensor Types:(%%) ====
2.2	234
99.2	235	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:100px" %)
2.2	236	\|Byte3\|Byte2\|Byte1
	237
	238	Bit = 1 means this sensor is connected, Bit=0 means this sensor is not connected
	239
99.2	240	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:520px" %)
	241	\|(% rowspan="2" style="width:53px" %)Byte3\|(% style="width:71px" %)Bit23\|(% style="width:113px" %)Bit22\|(% style="width:112px" %)Bit21\|(% style="width:113px" %)Bit20\|(% style="width:112px" %)Bit19\|(% style="width:70px" %)Bit18\|(% style="width:72px" %)Bit17\|(% style="width:53px" %)Bit16
	242	\|(% style="width:71px" %)N/A\|(% style="width:113px" %)Customize-A4\|(% style="width:112px" %)Customize-A3\|(% style="width:113px" %)Customize-A2\|(% style="width:112px" %)Customize-A1\|(% style="width:70px" %)N/A\|(% style="width:72px" %)N/A\|(% style="width:53px" %)N/A
	243	\|(% rowspan="2" style="width:53px" %)Byte2\|(% style="width:71px" %)Bit15\|(% style="width:113px" %)Bit14\|(% style="width:112px" %)Bit13\|(% style="width:113px" %)Bit12\|(% style="width:112px" %)Bit11\|(% style="width:70px" %)Bit10\|(% style="width:72px" %)Bit9\|(% style="width:53px" %)Bit8
	244	\|(% style="width:71px" %)N/A\|(% style="width:113px" %)N/A\|(% style="width:112px" %)N/A\|(% style="width:113px" %)N/A\|(% style="width:112px" %)N/A\|(% style="width:70px" %)N/A\|(% style="width:72px" %)N/A\|(% style="width:53px" %)N/A
	245	\|(% rowspan="2" style="width:53px" %)Byte1\|(% style="width:71px" %)Bit7\|(% style="width:113px" %)Bit6\|(% style="width:112px" %)Bit5\|(% style="width:113px" %)Bit4\|(% style="width:112px" %)Bit3\|(% style="width:70px" %)Bit2\|(% style="width:72px" %)Bit1\|(% style="width:53px" %)Bit0
	246	\|(% style="width:71px" %)WSS-07\|(% style="width:113px" %)WSS-06\|(% style="width:112px" %)WSS-05\|(% style="width:113px" %)WSS-04\|(% style="width:112px" %)WSS-03\|(% style="width:70px" %)WSS-02\|(% style="width:72px" %)WSS-01\|(% style="width:53px" %)N/A
	247
2.2	248	Eg: 0x1000FE = 1 0000 0000 0000 1111 1110(b)
	249
	250	External sensors detected by WSC1-L include :
	251
	252	custom sensor A1,
	253
	254	PAR sensor (WSS-07),
	255
	256	Total Solar Radiation sensor (WSS-06),
	257
	258	CO2/PM2.5/PM10 (WSS-03),
	259
	260	Wind Speed/Direction (WSS-02)
	261
	262
	263	User can also use downlink command(0x26 01) to ask WSC1-L to resend this uplink :
	264
3.2	265	(% style="color:#037691" %)Downlink:0x26 01
2.2	266
104.10	267	[[image:1656049673488-415.png]]
2.2	268
	269
6.4	270	=== 2.4.2 Uplink FPORT~=2, Real time sensor value ===
2.2	271
91.13	272
16.5	273	(((
16.4	274	WSC1-L will send this uplink after Device Config uplink once join LoRaWAN network successfully. And it will periodically send this uplink. Default interval is 20 minutes and [[can be changed>>\|\|anchor="H3.1SetTransmitIntervalTime"]].
16.5	275	)))
2.2	276
16.5	277	(((
2.2	278	Uplink uses FPORT=2 and every 20 minutes send one uplink by default.
16.5	279	)))
2.2	280
	281
16.5	282	(((
2.2	283	The upload length is dynamic, depends on what type of weather sensors are connected. The uplink payload is combined with sensor segments. As below:
16.5	284	)))
2.2	285
16.6	286
	287	(% style="color:#4472c4" %) Uplink Payload:
	288
104.4	289	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:464px" %)
16.5	290	\|(% style="width:140px" %)Sensor Segment 1\|(% style="width:139px" %)Sensor Segment 2\|(% style="width:42px" %)……\|(% style="width:140px" %)Sensor Segment n
2.2	291
3.11	292	(% style="color:#4472c4" %) Sensor Segment Define:
2.2	293
99.4	294	(% border="1" cellspacing="10" style="background-color:#f2f2f2; width:330px" %)
16.6	295	\|(% style="width:89px" %)Type Code\|(% style="width:114px" %)Length (Bytes)\|(% style="width:124px" %)Measured Value
2.2	296
20.2	297	(% style="color:#4472c4" %)Sensor Type Table:
2.2	298
104.7	299	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:520px" %)
105.5	300	\|(% style="background-color:#d9e2f3; color:#0070c0; width:80px" %)Sensor Type\|(% style="background-color:#d9e2f3; color:#0070c0; width:75px" %)Type Code\|(% style="background-color:#d9e2f3; color:#0070c0; width:95px" %)Range\|(% style="background-color:#d9e2f3; color:#0070c0; width:80px" %)Length( Bytes)\|(% style="background-color:#d9e2f3; color:#0070c0; width:190px" %)Example
104.3	301	\|(% style="width:103px" %)Wind Speed\|(% style="width:91px" %)0x01\|(% style="width:158px" %)(((
104.7	302	(((
104.2	303	Speed: 0～60m/s
104.7	304	)))
104.2	305
104.7	306	(((
104.2	307	Level: 0～17
104.7	308	)))
104.3	309	)))\|(% style="width:122px" %)0x03 \|(% style="width:904px" %)(((
104.7	310	(((
104.2	311	0x0024/10=3.6m/s (0x02FE: No Sensor, 0x02EE: Value Error)
104.7	312	)))
104.2	313
104.7	314	(((
104.2	315	0x02=2 (0x14: No Sensor, 0x15: Value Error)
	316	)))
104.7	317	)))
104.3	318	\|(% style="width:103px" %)Wind Direction\|(% style="width:91px" %)0x02\|(% style="width:158px" %)(((
104.7	319	(((
104.2	320	Angel: 0～360°
104.7	321	)))
104.2	322
104.7	323	(((
104.2	324	Direction: 16 positions
104.7	325	)))
104.3	326	)))\|(% style="width:122px" %)0x03\|(% style="width:904px" %)(((
104.7	327	(((
104.2	328	0x02C9/10=66.6°(0x0EFE: No Sensor,0x0EFF: Value Error)
104.7	329	)))
104.2	330
104.7	331	(((
104.2	332	0X03=3(ENE) (0x14: No Sensor,0x15: Value Error)
	333	)))
104.7	334	)))
	335	\|(% style="width:103px" %)Illumination\|(% style="width:91px" %)0x03\|(% style="width:158px" %)0～200000kLux\|(% style="width:122px" %)0x02\|(% style="width:904px" %)(((
	336	0x04D2*10=12340kLux (0x4EFE: No Sensor,0x4EFF: Value Error)
	337	)))
104.3	338	\|(% style="width:103px" %)Rain / Snow\|(% style="width:91px" %)0x04\|(% style="width:158px" %)0A: No, 01 Yes.\|(% style="width:122px" %)0x01\|(% style="width:904px" %)(((
104.7	339	(((
104.2	340	0x00 (00) No Rain or snow detected
104.7	341	)))
104.2	342
104.7	343	(((
104.2	344	(0x02: No Sensor,0x03: Value Error)
	345	)))
104.7	346	)))
	347	\|(% style="width:103px" %)CO2\|(% style="width:91px" %)0x05\|(% style="width:158px" %)0～5000ppm\|(% style="width:122px" %)0x02\|(% style="width:904px" %)(((
	348	0x0378=888ppm (0x14FE: No Sensor,0x14FF: Value Error)
	349	)))
	350	\|(% style="width:103px" %)Temperature\|(% style="width:91px" %)0x06\|(% style="width:158px" %)-30℃～70℃\|(% style="width:122px" %)0x02\|(% style="width:904px" %)(((
	351	0xFFDD/10=-3.5℃ (0x02FE: No Sensor,0x02FF: Value Error)
	352	)))
	353	\|(% style="width:103px" %)Humidity\|(% style="width:91px" %)0x07\|(% style="width:158px" %)0～100%RH\|(% style="width:122px" %)0x02\|(% style="width:904px" %)(((
	354	0x0164/10=35.6%RH (0x03FE: No Sensor,0x03FF: Value Error)
	355	)))
	356	\|(% style="width:103px" %)Pressure\|(% style="width:91px" %)0x08\|(% style="width:158px" %)10～1100hPa\|(% style="width:122px" %)0x02\|(% style="width:904px" %)(((
	357	0x2748/10=1005.6hPa (0x00: No Sensor,0x01: Value Error)
	358	)))
	359	\|(% style="width:103px" %)Rain Gauge\|(% style="width:91px" %)0x09\|(% style="width:158px" %)(((
	360	0mm～100mm(Rainfall in the last 24 hours)
	361	)))\|(% style="width:122px" %)0x02\|(% style="width:904px" %)(((
	362	(((
104.3	363	0x0050/10=8mm (Rainfall within the 24 hours:8.0mm)
104.7	364	)))
104.2	365
104.7	366	(((
104.3	367	(0x03FE: No Sensor,0x03FF: Value Error)
104.2	368	)))
104.7	369	)))
	370	\|(% style="width:103px" %)PM2.5\|(% style="width:91px" %)0x0A\|(% style="width:158px" %)0～1000μg/m^^3^^\|(% style="width:122px" %)0x02\|(% style="width:904px" %)(((
	371	0x0023=35μg/m^^3 ^^(0x03FE: No Sensor,0x03FF: Value Error)
	372	)))
	373	\|(% style="width:103px" %)PM10\|(% style="width:91px" %)0x0B\|(% style="width:158px" %)0～1000μg/m^^3^^\|(% style="width:122px" %)0x02\|(% style="width:904px" %)(((
	374	0x002D=45μg/m^^3 ^^(0x03FE: No Sensor,0x03FF: Value Error)
	375	)))
	376	\|(% style="width:103px" %)PAR\|(% style="width:91px" %)0x0C\|(% style="width:158px" %)(((
	377	0～2500μmol/m^^2^^•s
	378	)))\|(% style="width:122px" %)0x02\|(% style="width:904px" %)(((
	379	0x00B3=179μmol/m^^2^^•s (0x09FE: No Sensor,0x09FF: Value Error)
	380	)))
104.3	381	\|(% style="width:103px" %)(((
	382	Total Solar
104.2	383
104.3	384	Radiation
104.7	385	)))\|(% style="width:91px" %)0x0D\|(% style="width:158px" %)0～2000W/m^^2^^\|(% style="width:122px" %)0x02\|(% style="width:904px" %)(((
	386	0x0073/10=11.5W/m^^2^^(0x4EFE: No Sensor,0x4EFF: Value Error)
	387	)))
104.2	388
79.7	389	(((
104.10	390	Below is an example payload: [[image:image-20220624140615-3.png]]
79.7	391	)))
2.2	392
79.7	393	(((
	394
	395	)))
2.2	396
79.7	397	(((
20.2	398	When sending this payload to LoRaWAN server. WSC1-L will send this in one uplink or several uplinks according to LoRaWAN spec requirement. For example, total length of Payload is 54 bytes.
79.7	399	)))
2.2	400
79.7	401	* (((
	402	When WSC1-L sending in US915 frequency DR0 data rate. Because this data rate has limitation of 11 bytes payload for each uplink. The payload will be split into below packets and uplink.
	403	)))
2.2	404
79.7	405	(((
104.10	406	Uplink 1: [[image:image-20220624140735-4.png]]
79.7	407	)))
2.2	408
79.8	409
	410	(((
104.10	411	Uplink 2: [[image:image-20220624140842-5.png]]
79.7	412
	413	)))
2.2	414
79.7	415	* (((
	416	When WSC1-L sending in EU868 frequency DR0 data rate. The payload will be split into below packets and uplink:
	417	)))
2.2	418
79.7	419	(((
104.10	420	Uplink 1: [[image:image-20220624141025-6.png]]
79.7	421	)))
2.2	422
79.8	423
104.10	424	Uplink 2: [[image:image-20220624141100-7.png]]
2.2	425
	426
3.5	427	=== 2.4.3 Decoder in TTN V3 ===
2.2	428
91.13	429
79.22	430	(((
2.2	431	In LoRaWAN platform, user only see HEX payload by default, user needs to use payload formatters to decode the payload to see human-readable value.
79.22	432	)))
2.2	433
79.22	434	(((
91.15	435	Download decoder for suitable platform from: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
79.22	436	)))
2.2	437
	438
79.22	439	(((
2.2	440	and put as below:
79.22	441	)))
2.2	442
104.10	443	[[image:1656051152438-578.png]]
2.2	444
	445
3.5	446	== 2.5 Show data on Application Server ==
2.2	447
91.13	448
79.24	449	(((
2.2	450	Application platform provides a human friendly interface to show the sensor data, once we have sensor data in TTN V3, we can use Datacake to connect to TTN V3 and see the data in Datacake. Below are the steps:
79.24	451	)))
2.2	452
79.24	453	(((
3.11	454	(% style="color:blue" %)Step 1(%%): Be sure that your device is programmed and properly connected to the LoRaWAN network.
79.24	455	)))
2.2	456
79.24	457	(((
3.11	458	(% style="color:blue" %)Step 2(%%): Configure your Application to forward data to Datacake you will need to add integration. Go to TTN V3 Console ~-~-> Applications ~-~-> Integrations ~-~-> Add Integrations.
79.24	459	)))
2.2	460
104.10	461	[[image:1656051197172-131.png]]
2.2	462
	463
91.13	464
26.2	465	Add TagoIO:
2.2	466
104.10	467	[[image:1656051223585-631.png]]
2.2	468
	469
91.13	470
26.2	471	Authorization:
2.2	472
104.10	473	[[image:1656051248318-368.png]]
2.2	474
26.2	475
91.13	476
2.2	477	In TagoIO console ([[https:~~/~~/admin.tago.io~~/~~/>>url:https://datacake.co/]]) , add WSC1-L:
	478
91.13	479
104.10	480	[[image:1656051277767-168.png]]
2.2	481
	482
3.5	483	= 3. Configure WSC1-L via AT Command or LoRaWAN Downlink =
	484
91.13	485
2.2	486	Use can configure WSC1-L via AT Command or LoRaWAN Downlink.
	487
27.4	488	* AT Command Connection: See [[FAQ>>\|\|anchor="H7.FAQ"]].
27.3	489	* LoRaWAN Downlink instruction for different platforms: [[Use Note for Server>>doc:Main.WebHome]](IoT LoRaWAN Server)
2.2	490
	491	There are two kinds of commands to configure WSC1-L, they are:
	492
3.11	493	* (% style="color:#4472c4" %)General Commands.
2.2	494
	495	These commands are to configure:
	496
	497	* General system settings like: uplink interval.
	498	* LoRaWAN protocol & radio related command.
	499
27.5	500	They are same for all Dragino Device which support DLWS-005 LoRaWAN Stack((% style="color:red" %)Note~~)(%%). These commands can be found on the wiki: [[End Device Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
2.2	501
91.13	502	(% style="color:red" %)*Note~~: Please check early user manual if you don’t have v1.8.0 firmware. *
2.2	503
	504
3.11	505	* (% style="color:#4472c4" %)Commands special design for WSC1-L
2.2	506
	507	These commands only valid for WSC1-L, as below:
	508
	509
3.5	510	== 3.1 Set Transmit Interval Time ==
2.2	511
91.13	512
2.2	513	Feature: Change LoRaWAN End Node Transmit Interval.
	514
3.11	515	(% style="color:#037691" %)AT Command: AT+TDC
2.2	516
104.7	517	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:501px" %)
	518	\|(% style="background-color:#d9e2f3; color:#0070c0; width:155px" %)Command Example\|(% style="background-color:#d9e2f3; color:#0070c0; width:166px" %)Function\|(% style="background-color:#d9e2f3; color:#0070c0; width:180px" %)Response
	519	\|(% style="width:155px" %)AT+TDC=?\|(% style="width:162px" %)Show current transmit Interval\|(% style="width:177px" %)(((
	520	30000
	521	OK
	522	the interval is 30000ms = 30s
	523	)))
	524	\|(% style="width:155px" %)AT+TDC=60000\|(% style="width:162px" %)Set Transmit Interval\|(% style="width:177px" %)(((
	525	OK
	526	Set transmit interval to 60000ms = 60 seconds
	527	)))
2.2	528
3.11	529	(% style="color:#037691" %)Downlink Command: 0x01
2.2	530
	531	Format: Command Code (0x01) followed by 3 bytes time value.
	532
104.7	533	If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
2.2	534
94.2	535	* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
	536	* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
2.2	537
105.7	538
	539
	540
3.5	541	== 3.2 Set Emergency Mode ==
	542
91.13	543
2.2	544	Feature: In emergency mode, WSC1-L will uplink data every 1 minute.
	545
3.11	546	(% style="color:#037691" %)AT Command:
2.2	547
105.7	548	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:466px" %)
	549	\|(% style="background-color:#d9e2f3; color:#0070c0; width:156px" %)Command Example\|(% style="background-color:#d9e2f3; color:#0070c0; width:225px" %)Function\|(% style="background-color:#d9e2f3; color:#0070c0; width:85px" %)Response
104.7	550	\|(% style="width:155px" %)AT+ALARMMOD=1\|(% style="width:224px" %)Enter emergency mode. Uplink every 1 minute\|(% style="width:84px" %)(((
	551	OK
	552
	553	)))
	554	\|(% style="width:155px" %)AT+ALARMMOD=0\|(% style="width:224px" %)Exit emergency mode. Uplink base on TDC time\|(% style="width:84px" %)(((
	555	OK
	556	)))
2.2	557
3.11	558	(% style="color:#037691" %)Downlink Command:
2.2	559
	560	* 0xE101 Same as: AT+ALARMMOD=1
	561	* 0xE100 Same as: AT+ALARMMOD=0
	562
105.8	563
	564
	565
3.5	566	== 3.3 Add or Delete RS485 Sensor ==
	567
91.13	568
79.25	569	(((
2.2	570	Feature: User can add or delete 3^^rd^^ party sensor as long they are RS485/Modbus interface,baud rate support 9600.Maximum can add 4 sensors.
79.25	571	)))
2.2	572
79.25	573	(((
3.11	574	(% style="color:#037691" %)AT Command:
79.25	575	)))
2.2	576
79.25	577	(((
31.4	578	(% style="color:blue" %)AT+DYSENSOR=Type_Code, Query_Length, Query_Command , Read_Length , Valid_Data ,has_CRC,timeout
79.25	579	)))
2.2	580
79.25	581	* (((
	582	Type_Code range: A1 ~~ A4
	583	)))
	584	* (((
	585	Query_Length: RS485 Query frame length, Value cannot be greater than 10
	586	)))
	587	* (((
	588	Query_Command: RS485 Query frame data to be sent to sensor, cannot be larger than 10 bytes
	589	)))
	590	* (((
	591	Read_Length: RS485 response frame length supposed to receive. Max can receive
	592	)))
	593	* (((
	594	Valid_Data: valid data from RS485 Response, Valid Data will be added to Payload and upload via LoRaWAN.
	595	)))
	596	* (((
	597	has_CRC: RS485 Response crc check (0: no verification required 1: verification required). If CRC=1 and CRC error, valid data will be set to 0.
	598	)))
	599	* (((
	600	timeout: RS485 receive timeout (uint:ms). Device will close receive window after timeout
	601	)))
2.2	602
79.25	603	(((
31.2	604	Example:
79.25	605	)))
31.2	606
79.25	607	(((
2.2	608	User need to change external sensor use the type code as address code.
79.25	609	)))
2.2	610
79.25	611	(((
2.2	612	With a 485 sensor, after correctly changing the address code to A1, the RS485 query frame is shown in the following table:
79.25	613	)))
2.2	614
104.10	615	[[image:image-20220624143553-10.png]]
2.2	616
31.2	617
2.2	618	The response frame of the sensor is as follows:
	619
104.10	620	[[image:image-20220624143618-11.png]]
2.2	621
31.2	622
31.6	623	Then the following parameters should be:
2.2	624
	625	* Address_Code range: A1
	626	* Query_Length: 8
	627	* Query_Command: A103000000019CAA
	628	* Read_Length: 8
96.1	629	* Valid_Data: 23 (Indicates that the data length is 2 bytes, starting from the 3th byte)
2.2	630	* has_CRC: 1
	631	* timeout: 1500 (Fill in the test according to the actual situation)
	632
31.6	633	So the input command is:
	634
2.2	635	AT+DYSENSOR=A1,8,A103000000019CAA,8,24,1,1500
	636
	637
	638	In every sampling. WSC1-L will auto append the sensor segment as per this structure and uplink.
	639
104.8	640	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:351px" %)
	641	\|=(% style="width: 95px;background-color:#D9E2F3;color:#0070C0" %)Type Code\|=(% style="width: 122px;background-color:#D9E2F3;color:#0070C0" %)Length (Bytes)\|=(% style="width: 134px;background-color:#D9E2F3;color:#0070C0" %)Measured Value
31.5	642	\|(% style="width:94px" %)A1\|(% style="width:121px" %)2\|(% style="width:132px" %)0x000A
2.2	643
31.6	644	Related commands:
2.2	645
31.5	646	AT+DYSENSOR=A1,0 ~-~-> Delete 3^^rd^^ party sensor A1.
2.2	647
31.5	648	AT+DYSENSOR ~-~-> List All 3^^rd^^ Party Sensor. Like below:
2.2	649
	650
3.11	651	(% style="color:#037691" %)Downlink Command:
2.2	652
	653	delete custom sensor A1:
	654
	655	* 0xE5A1 Same as: AT+DYSENSOR=A1,0
	656
	657	Remove all custom sensors
	658
	659	* 0xE5FF
	660
105.8	661
	662
	663
	664
3.5	665	== 3.4 RS485 Test Command ==
	666
91.13	667
3.11	668	(% style="color:#037691" %)AT Command:
3.5	669
105.12	670	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:494px" %)
	671	\|=(% style="width: 160px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 248px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 86px;background-color:#D9E2F3;color:#0070C0" %)Response
31.7	672	\|(% style="width:159px" %)AT+RSWRITE=xxxxxx\|(% style="width:227px" %)(((
105.9	673	Send command to 485 sensor. Range : no more than 10 bytes
31.7	674	)))\|(% style="width:85px" %)OK
2.2	675
	676	Eg: Send command 01 03 00 00 00 01 84 0A to 485 sensor
	677
	678	AT+RSWRITE=0103000001840A
	679
	680
3.11	681	(% style="color:#037691" %)Downlink Command:
2.2	682
	683	* 0xE20103000001840A Same as: AT+RSWRITE=0103000001840A
	684
105.8	685
	686
	687
	688
3.5	689	== 3.5 RS485 response timeout ==
2.2	690
91.13	691
2.2	692	Feature: Set or get extended time to receive 485 sensor data.
	693
3.11	694	(% style="color:#037691" %)AT Command:
2.2	695
104.8	696	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:433px" %)
	697	\|=(% style="width: 157px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 190px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 86px;background-color:#D9E2F3;color:#0070C0" %)Response
31.8	698	\|(% style="width:157px" %)AT+DTR=1000\|(% style="width:188px" %)(((
105.8	699	Set response timeout to: Range : 0~~10000
31.8	700	)))\|(% style="width:85px" %)OK
2.2	701
3.11	702	(% style="color:#037691" %)Downlink Command:
2.2	703
	704	Format: Command Code (0xE0) followed by 3 bytes time value.
	705
	706	If the downlink payload=E0000005, it means set the END Node’s Transmit Interval to 0x000005=5(S), while type code is E0.
	707
94.2	708	* Example 1: Downlink Payload: E0000005 ~/~/ Set Transmit Interval (DTR) = 5 seconds
	709	* Example 2: Downlink Payload: E000000A ~/~/ Set Transmit Interval (DTR) = 10 seconds
2.2	710
105.13	711
	712
	713
	714
3.5	715	== 3.6 Set Sensor Type ==
	716
91.13	717
79.10	718	(((
2.2	719	Feature: Set sensor in used. If there are 6 sensors, user can set to only send 5 sensors values.
79.10	720	)))
2.2	721
79.10	722	(((
32.7	723	See [[definition>>\|\|anchor="HWeatherSensorTypes:"]] for the sensor type.
104.8	724
104.9	725	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:520px" %)
104.8	726	\|(% rowspan="2" %)Byte3\|Bit23\|Bit22\|Bit21\|Bit20\|Bit19\|Bit18\|Bit17\|Bit16
	727	\| \|A4\|A3\|A2\|A1\| \| \|
	728	\|(% rowspan="2" %)Byte2\|Bit15\|Bit14\|Bit13\|Bit12\|Bit11\|Bit10\|Bit9\|Bit8
	729	\| \| \|Solar Radiation\|PAR\|PM10\|PM2.5\|(((
	730	Rain
	731	Gauge
	732	)))\|(((
	733	Air
	734	Pressure
79.10	735	)))
104.8	736	\|(% rowspan="2" %)Byte1\|Bit7\|Bit6\|Bit5\|Bit4\|Bit3\|Bit2\|Bit1\|Bit0
	737	\|Humidity\|Temperature\|CO2\|(((
	738	Rain/Snow
	739	Detect
	740	)))\|illuminance\|(((
	741	Wind
	742	Direction
	743	)))\|Wind Speed\|BAT
	744	)))
	745
2.2	746
3.11	747	(% style="color:#037691" %)AT Command:
2.2	748
104.8	749	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:377px" %)
	750	\|=(% style="width: 157px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 132px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 88px;background-color:#D9E2F3;color:#0070C0" %)Response
94.1	751	\|(% style="width:157px" %)AT+STYPE=80221\|(% style="width:130px" %)Set sensor types\|(% style="width:87px" %)OK
2.2	752
94.1	753	Eg: The setting command AT+STYPE=80221 means:
2.2	754
104.8	755	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:495px" %)
32.4	756	\|(% rowspan="2" style="width:57px" %)Byte3\|(% style="width:57px" %)Bit23\|(% style="width:59px" %)Bit22\|(% style="width:56px" %)Bit21\|(% style="width:51px" %)Bit20\|(% style="width:54px" %)Bit19\|(% style="width:54px" %)Bit18\|(% style="width:52px" %)Bit17\|(% style="width:52px" %)Bit16
	757	\|(% style="width:57px" %)0\|(% style="width:59px" %)0\|(% style="width:56px" %)0\|(% style="width:51px" %)0\|(% style="width:54px" %)1\|(% style="width:54px" %)0\|(% style="width:52px" %)0\|(% style="width:52px" %)0
	758	\|(% rowspan="2" style="width:57px" %)Byte2\|(% style="width:57px" %)Bit15\|(% style="width:59px" %)Bit14\|(% style="width:56px" %)Bit13\|(% style="width:51px" %)Bit12\|(% style="width:54px" %)Bit11\|(% style="width:54px" %)Bit10\|(% style="width:52px" %)Bit9\|(% style="width:52px" %)Bit8
	759	\|(% style="width:57px" %)0\|(% style="width:59px" %)0\|(% style="width:56px" %)0\|(% style="width:51px" %)0\|(% style="width:54px" %)0\|(% style="width:54px" %)0\|(% style="width:52px" %)1\|(% style="width:52px" %)0
	760	\|(% rowspan="2" style="width:57px" %)Byte1\|(% style="width:57px" %)Bit7\|(% style="width:59px" %)Bit6\|(% style="width:56px" %)Bit5\|(% style="width:51px" %)Bit4\|(% style="width:54px" %)Bit3\|(% style="width:54px" %)Bit2\|(% style="width:52px" %)Bit1\|(% style="width:52px" %)Bit0
	761	\|(% style="width:57px" %)0\|(% style="width:59px" %)0\|(% style="width:56px" %)1\|(% style="width:51px" %)0\|(% style="width:54px" %)0\|(% style="width:54px" %)0\|(% style="width:52px" %)0\|(% style="width:52px" %)1
2.2	762
	763	So wsc1-L will upload the following data: Custom Sensor A1, Rain Gauge,CO2,BAT.
	764
	765
3.11	766	(% style="color:#037691" %)Downlink Command:
2.2	767
94.1	768	* 0xE400080221 Same as: AT+STYPE=80221
2.2	769
3.5	770	(% style="color:red" %)Note:
2.2	771
32.5	772	~1. The sensor type will not be saved to flash, and the value will be updated every time the sensor is restarted or rescanned.
2.2	773
	774
105.15	775	== 3.7 Set the registers read by the rain gauge(Since firmware V1.3) ==
105.1	776
105.2	777
105.1	778	(% style="color:#037691" %)AT Command:
	779
	780	(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:433px" %)
105.14	781	\|=(% style="width: 172px; background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 175px; background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 86px;background-color:#D9E2F3;color:#0070C0" %)Response
105.1	782	\|(% style="width:161px" %)(((
105.13	783	AT+RAINFALLSWITCH=1(Range: 1~~10)
105.1	784	)))\|(% style="width:184px" %)(((
	785	Set the registers read by the rain gauge
	786	)))\|(% style="width:85px" %)OK
	787
	788	(% style="color:#037691" %)Downlink Command:
	789
	790	* 0x1701 Same as: AT+RAINFALLSWITCH=1
	791
	792
105.3	793
3.5	794	= 4. Power consumption and battery =
2.2	795
3.5	796	== 4.1 Total Power Consumption ==
	797
91.14	798
2.2	799	Dragino Weather Station serial products include the main process unit ( WSC1-L ) and various sensors. The total power consumption equal total power of all above units. The power consumption for main process unit WSC1-L is 18ma @ 12v. and the power consumption of each sensor can be found on the Sensors chapter.
	800
	801
3.5	802	== 4.2 Reduce power consumption ==
2.2	803
91.14	804
2.2	805	The main process unit WSC1-L is set to LoRaWAN Class C by default. If user want to reduce the power consumption of this unit, user can set it to run in Class A. In Class A mode, WSC1-L will not be to get real-time downlink command from IoT Server.
	806
	807
3.5	808	== 4.3 Battery ==
2.2	809
91.14	810
32.8	811	(((
	812	All sensors are only power by external power source. If external power source is off. All sensor won't work.
	813	)))
2.2	814
32.8	815	(((
2.2	816	Main Process Unit WSC1-L is powered by both external power source and internal 1000mAh rechargeable battery. If external power source is off, WSC1-L still runs and can send periodically uplinks, but the sensors value will become invalid. External power source can recharge the 1000mAh rechargeable battery.
32.8	817	)))
2.2	818
	819
3.5	820	= 5. Main Process Unit WSC1-L =
2.2	821
3.5	822	== 5.1 Features ==
2.2	823
91.14	824
2.2	825	* Wall Attachable.
	826	* LoRaWAN v1.0.3 Class A protocol.
	827	* RS485 / Modbus protocol
	828	* Frequency Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915
	829	* AT Commands to change parameters
	830	* Remote configure parameters via LoRaWAN Downlink
	831	* Firmware upgradable via program port
	832	* Powered by external 12v battery
	833	* Back up rechargeable 1000mAh battery
	834	* IP Rating: IP65
	835	* Support default sensors or 3rd party RS485 sensors
	836
3.5	837	== 5.2 Power Consumption ==
	838
91.14	839
2.2	840	WSC1-L (without external sensor): Idle: 4mA, Transmit: max 40mA
	841
	842
3.5	843	== 5.3 Storage & Operation Temperature ==
2.2	844
91.14	845
2.2	846	-20°C to +60°C
	847
	848
3.5	849	== 5.4 Pin Mapping ==
2.2	850
91.14	851
104.10	852	[[image:1656054149793-239.png]]
2.2	853
	854
3.5	855	== 5.5 Mechanical ==
2.2	856
	857
91.14	858	Refer LSn50v2 enclosure drawing in: [[https:~~/~~/www.dropbox.com/sh/0ir0l9jjmk6p95e/AADwWXorcKuNpPR5em7VgrEja?dl=0>>https://www.dropbox.com/sh/0ir0l9jjmk6p95e/AADwWXorcKuNpPR5em7VgrEja?dl=0]]
2.2	859
91.14	860
3.5	861	== 5.6 Connect to RS485 Sensors ==
2.2	862
91.14	863
2.2	864	WSC1-L includes a RS485 converter PCB. Which help it easy to connect multiply RS485 sensors. Below is the photo for reference.
	865
	866
104.10	867	[[image:1656054389031-379.png]]
2.2	868
	869
	870	Hardware Design for the Converter Board please see:
	871
91.14	872	[[https:~~/~~/www.dropbox.com/sh/bqyvsvitb70qtgf/AABLpD7_yxsQ_drVMxHIEI7wa?dl=0>>https://www.dropbox.com/sh/bqyvsvitb70qtgf/AABLpD7_yxsQ_drVMxHIEI7wa?dl=0]]
2.2	873
	874
3.6	875	= 6. Weather Sensors =
2.2	876
3.6	877	== 6.1 Rain Gauge ~-~- WSS-01 ==
	878
34.4	879
40.3	880	(((
2.2	881	WSS-01 RS485 Rain Gauge is used in meteorology and hydrology to gather and measure the amount of liquid precipitation (mainly rainfall) over an area.
40.3	882	)))
2.2	883
40.3	884	(((
34.4	885	WSS-01 uses a tipping bucket to detect rainfall. The tipping bucket use 3D streamline shape to make sure it works smoothly and is easy to clean.
40.3	886	)))
2.2	887
40.3	888	(((
34.4	889	WSS-01 is designed to support the Dragino Weather station solution. Users only need to connect WSS-01 RS485 interface to WSC1-L. The weather station main processor WSC1-L can detect and upload the rainfall to the IoT Server via wireless LoRaWAN protocol
40.3	890	)))
2.2	891
40.3	892	(((
34.4	893	The tipping bucket of WSS-01 is adjusted to the best angle. When installation, user only needs to screw up and adjust the bottom horizontally.
40.3	894	)))
2.2	895
40.3	896	(((
2.2	897	WSS-01 package includes screw which can be installed to ground. If user want to install WSS-01 on pole, they can purchase WS-K2 bracket kit.
40.3	898	)))
2.2	899
	900
3.6	901	=== 6.1.1 Feature ===
3.10	902
91.14	903
2.2	904	* RS485 Rain Gauge
	905	* Small dimension, easy to install
	906	* Vents under funnel, avoid leaf or other things to avoid rain flow.
	907	* ABS enclosure.
	908	* Horizontal adjustable.
	909
3.6	910	=== 6.1.2 Specification ===
3.10	911
91.14	912
2.2	913	* Resolution: 0.2mm
	914	* Accuracy: ±3%
91.1	915	* Range: 0 ~~ 100mm
2.2	916	* Rainfall strength: 0mm～4mm/min (max 8mm/min)
	917	* Input Power: DC 5~~24v
	918	* Interface: RS485
	919	* Working Temperature: 0℃～70℃ ( incorrect below 0 degree, because water become ICE)
	920	* Working Humidity: <100% (no dewing)
	921	* Power Consumption: 4mA @ 12v.
	922
3.6	923	=== 6.1.3 Dimension ===
	924
91.14	925
104.10	926	[[image:1656054957406-980.png]]
2.2	927
	928
3.9	929	=== 6.1.4 Pin Mapping ===
	930
91.14	931
104.10	932	[[image:1656054972828-692.png]]
2.2	933
	934
3.6	935	=== 6.1.5 Installation Notice ===
2.2	936
91.14	937
79.11	938	(((
2.2	939	Do not power on while connect the cables. Double check the wiring before power on.
79.11	940	)))
2.2	941
79.11	942	(((
2.2	943	Installation Photo as reference:
79.11	944	)))
2.2	945
	946
79.11	947	(((
3.11	948	(% style="color:#4472c4" %) Install on Ground:
79.11	949	)))
2.2	950
79.11	951	(((
2.2	952	WSS-01 Rain Gauge include screws so can install in ground directly .
79.11	953	)))
2.2	954
	955
79.11	956	(((
3.11	957	(% style="color:#4472c4" %) Install on pole:
79.11	958	)))
2.2	959
79.11	960	(((
3.11	961	If user want to install on pole, they can purchase the (% style="color:#4472c4" %) WS-K2 : Bracket Kit for Pole installation(%%), and install as below:
79.11	962	)))
2.2	963
104.10	964	[[image:image-20220624152218-1.png\|\|height="526" width="276"]]
2.2	965
39.2	966	WS-K2: Bracket Kit for Pole installation
2.2	967
	968
	969	WSSC-K2 dimension document, please see:
	970
91.14	971	[[https:~~/~~/www.dropbox.com/sh/7wa2elfm2q8xq4l/AAB7ZB_gSVGrhmJEgU2LyTQNa?dl=0>>https://www.dropbox.com/sh/7wa2elfm2q8xq4l/AAB7ZB_gSVGrhmJEgU2LyTQNa?dl=0]]
2.2	972
	973
3.6	974	== 6.2 Wind Speed/Direction ~-~- WSS-02 ==
2.2	975
91.14	976
104.10	977	[[image:1656055444035-179.png]]
2.2	978
91.14	979
40.2	980	(((
2.2	981	WSS-02 is a RS485 wind speed and wind direction monitor designed for weather station solution.
40.2	982	)))
2.2	983
40.2	984	(((
2.2	985	WSS-02 shell is made of polycarbonate composite material, which has good anti-corrosion and anti-corrosion characteristics, and ensure the long-term use of the sensor without rust. At the same time, it cooperates with the internal smooth bearing system to ensure the stability of information collection
40.2	986	)))
2.2	987
40.2	988	(((
	989	Users only need to connect WSS-02 RS485 interface to WSC1-L. The weather station main processor WSC1-L can detect and upload the wind speed and direction to the IoT Server via wireless LoRaWAN protocol.
	990	)))
2.2	991
	992
3.6	993	=== 6.2.1 Feature ===
3.9	994
91.14	995
2.2	996	* RS485 wind speed / direction sensor
	997	* PC enclosure, resist corrosion
	998
3.6	999	=== 6.2.2 Specification ===
3.9	1000
91.14	1001
94.2	1002	* Wind speed range: 0 ~~ 60m/s
2.2	1003	* Wind direction range: 0 ~~ 360°
	1004	* Start wind speed: ≤0.3m/s
	1005	* Accuracy: ±（0.3＋0.03V）m/s , ±1°
	1006	* Input Power: DC 5~~24v
	1007	* Interface: RS485
	1008	* Working Temperature: -30℃～70℃
	1009	* Working Humidity: <100% (no dewing)
	1010	* Power Consumption: 13mA ~~ 12v.
	1011	* Cable Length: 2 meters
	1012
3.6	1013	=== 6.2.3 Dimension ===
	1014
91.14	1015
104.10	1016	[[image:image-20220624152813-2.png]]
2.2	1017
	1018
3.6	1019	=== 6.2.4 Pin Mapping ===
2.2	1020
91.14	1021
104.10	1022	[[image:1656056281231-994.png]]
2.2	1023
	1024
45.2	1025	=== 6.2.5 Angle Mapping ===
2.2	1026
91.14	1027
104.10	1028	[[image:1656056303845-585.png]]
2.2	1029
	1030
45.2	1031	=== 6.2.6 Installation Notice ===
2.2	1032
91.14	1033
79.12	1034	(((
2.2	1035	Do not power on while connect the cables. Double check the wiring before power on.
79.12	1036	)))
2.2	1037
79.12	1038	(((
2.2	1039	The sensor must be installed with below direction, towards North.
91.14	1040
	1041
79.12	1042	)))
2.2	1043
104.10	1044	[[image:image-20220624153901-3.png]]
2.2	1045
	1046
3.6	1047	== 6.3 CO2/PM2.5/PM10 ~-~- WSS-03 ==
2.2	1048
46.5	1049
46.6	1050	(((
2.2	1051	WSS-03 is a RS485 Air Quality sensor. It can monitor CO2, PM2.5 and PM10 at the same time.
46.6	1052	)))
2.2	1053
46.6	1054	(((
2.2	1055	WSS-03 uses weather proof shield which can make sure the sensors are well protected against UV & radiation.
46.6	1056	)))
2.2	1057
46.6	1058	(((
46.5	1059	WSS-03 is designed to support the Dragino Weather station solution. Users only need to connect WSS-03 RS485 interface to WSC1-L. The weather station main processor WSC1-L can detect and upload the environment CO2, PM2.5 and PM10 to the IoT Server via wireless LoRaWAN protocol.
46.6	1060	)))
2.2	1061
	1062
3.6	1063	=== 6.3.1 Feature ===
3.9	1064
91.14	1065
2.2	1066	* RS485 CO2, PM2.5, PM10 sensor
	1067	* NDIR to measure CO2 with Internal Temperature Compensation
	1068	* Laser Beam Scattering to PM2.5 and PM10
	1069
3.6	1070	=== 6.3.2 Specification ===
3.9	1071
91.14	1072
2.2	1073	* CO2 Range: 0～5000ppm, accuracy: ±3%F•S（25℃）
	1074	* CO2 resolution: 1ppm
	1075	* PM2.5/PM10 Range: 0～1000μg/m3 , accuracy ±3%F•S（25℃）
	1076	* PM2.5/PM10 resolution: 1μg/m3
	1077	* Input Power: DC 7 ~~ 24v
	1078	* Preheat time: 3min
	1079	* Interface: RS485
	1080	* Working Temperature:
	1081	** CO2: 0℃～50℃;
	1082	** PM2.5/PM10: -30 ~~ 50℃
	1083	* Working Humidity:
	1084	** PM2.5/PM10: 15～80%RH (no dewing)
	1085	** CO2: 0～95%RH
	1086	* Power Consumption: 50mA@ 12v.
	1087
3.6	1088	=== 6.3.3 Dimension ===
	1089
91.14	1090
104.10	1091	[[image:1656056708366-230.png]]
2.2	1092
	1093
3.6	1094	=== 6.3.4 Pin Mapping ===
2.2	1095
91.14	1096
104.10	1097	[[image:1656056722648-743.png]]
2.2	1098
	1099
3.7	1100	=== 6.3.5 Installation Notice ===
2.2	1101
91.14	1102
2.2	1103	Do not power on while connect the cables. Double check the wiring before power on.
	1104
91.14	1105
104.10	1106	[[image:1656056751153-304.png]]
2.2	1107
93.2	1108
104.10	1109	[[image:1656056766224-773.png]]
2.2	1110
	1111
51.3	1112	== 6.4 Rain/Snow Detect ~-~- WSS-04 ==
2.2	1113
	1114
51.3	1115	(((
2.2	1116	WSS-04 is a RS485 rain / snow detect sensor. It can monitor Rain or Snow event.
51.3	1117	)))
2.2	1118
51.3	1119	(((
2.2	1120	WSS-04 has auto heating feature, this ensures measurement more reliable.
51.3	1121	)))
2.2	1122
51.3	1123	(((
	1124	WSS-04 is designed to support the Dragino Weather station solution. Users only need to connect WSS-04 RS485 interface to WSC1-L. The weather station main processor WSC1-L can detect and upload the SNOW/Rain Event to the IoT Server via wireless LoRaWAN protocol.
	1125	)))
2.2	1126
	1127
3.7	1128	=== 6.4.1 Feature ===
3.9	1129
91.14	1130
2.2	1131	* RS485 Rain/Snow detect sensor
	1132	* Surface heating to dry
	1133	* grid electrode uses Electroless Nickel/Immersion Gold design for resist corrosion
	1134
3.7	1135	=== 6.4.2 Specification ===
3.9	1136
91.14	1137
2.2	1138	* Detect if there is rain or snow
	1139	* Input Power: DC 12 ~~ 24v
	1140	* Interface: RS485
	1141	* Working Temperature: -30℃～70℃
	1142	* Working Humidity: 10～90%RH
	1143	* Power Consumption:
	1144	** No heating: 12mA @ 12v,
	1145	** heating: 94ma @ 12v.
	1146
3.7	1147	=== 6.4.3 Dimension ===
	1148
91.14	1149
104.10	1150	[[image:1656056844782-155.png]]
2.2	1151
	1152
3.7	1153	=== 6.4.4 Pin Mapping ===
2.2	1154
91.14	1155
104.10	1156	[[image:1656056855590-754.png]]
2.2	1157
	1158
3.7	1159	=== 6.4.5 Installation Notice ===
2.2	1160
91.14	1161
2.2	1162	Do not power on while connect the cables. Double check the wiring before power on.
	1163
79.13	1164	(((
2.2	1165	Install with 15°degree.
79.13	1166	)))
2.2	1167
104.10	1168	[[image:1656056873783-780.png]]
2.2	1169
	1170
104.10	1171	[[image:1656056883736-804.png]]
2.2	1172
	1173
3.11	1174	=== 6.4.6 Heating ===
2.2	1175
91.14	1176
55.3	1177	(((
2.2	1178	WSS-04 supports auto-heat feature. When the temperature is below the heat start temperature 15℃, WSS-04 starts to heat and stop at stop temperature (default is 25℃).
55.3	1179	)))
2.2	1180
	1181
3.7	1182	== 6.5 Temperature, Humidity, Illuminance, Pressure ~-~- WSS-05 ==
2.2	1183
56.4	1184
	1185	(((
2.2	1186	WSS-05 is a 4 in 1 RS485 sensor which can monitor Temperature, Humidity, Illuminance and Pressure at the same time.
56.4	1187	)))
2.2	1188
56.4	1189	(((
	1190	WSS-05 is designed to support the Dragino Weather station solution. Users only need to connect WSS-05 RS485 interface to WSC1-L. The weather station main processor WSC1-L can detect and upload environment Temperature, Humidity, Illuminance, Pressure to the IoT Server via wireless LoRaWAN protocol.
	1191	)))
2.2	1192
	1193
3.7	1194	=== 6.5.1 Feature ===
	1195
91.14	1196
2.2	1197	* RS485 Temperature, Humidity, Illuminance, Pressure sensor
	1198
3.7	1199	=== 6.5.2 Specification ===
	1200
91.14	1201
2.2	1202	* Input Power: DC 12 ~~ 24v
	1203	* Interface: RS485
	1204	* Temperature Sensor Spec:
	1205	** Range: -30 ~~ 70℃
	1206	** resolution 0.1℃
	1207	** Accuracy: ±0.5℃
	1208	* Humidity Sensor Spec:
	1209	** Range: 0 ~~ 100% RH
	1210	** resolution 0.1 %RH
	1211	** Accuracy: 3% RH
	1212	* Pressure Sensor Spec:
	1213	** Range: 10～1100hPa
	1214	** Resolution: 0.1hPa
	1215	** Accuracy: ±0.1hPa
	1216	* Illuminate sensor:
	1217	** Range: 0～2/20/200kLux
	1218	** Resolution: 10 Lux
	1219	** Accuracy: ±3％FS
	1220	* Working Temperature: -30℃～70℃
	1221	* Working Humidity: 10～90%RH
	1222	* Power Consumption: 4mA @ 12v
	1223
3.7	1224	=== 6.5.3 Dimension ===
	1225
91.14	1226
104.10	1227	[[image:1656057170639-522.png]]
2.2	1228
	1229
3.7	1230	=== 6.5.4 Pin Mapping ===
2.2	1231
91.14	1232
104.10	1233	[[image:1656057181899-910.png]]
2.2	1234
	1235
3.7	1236	=== 6.5.5 Installation Notice ===
	1237
91.14	1238
2.2	1239	Do not power on while connect the cables. Double check the wiring before power on.
	1240
104.10	1241	[[image:1656057199955-514.png]]
2.2	1242
	1243
104.10	1244	[[image:1656057212438-475.png]]
2.2	1245
	1246
3.7	1247	== 6.6 Total Solar Radiation sensor ~-~- WSS-06 ==
2.2	1248
60.3	1249
	1250	(((
2.2	1251	WSS-06 is Total Radiation Sensor can be used to measure the total solar radiation in the spectral range of 0.3 to 3 μm (300 to 3000 nm). If the sensor face is down, the reflected radiation can be measured, and the shading ring can also be used to measure the scattered radiation.
60.3	1252	)))
2.2	1253
60.3	1254	(((
2.2	1255	The core device of the radiation sensor is a high-precision photosensitive element, which has good stability and high precision; at the same time, a precision-machined PTTE radiation cover is installed outside the sensing element, which effectively prevents environmental factors from affecting its performance
60.3	1256	)))
2.2	1257
60.3	1258	(((
64.2	1259	WSS-06 is designed to support the Dragino Weather station solution. Users only need to connect WSS-06 RS485 interface to WSC1-L. The weather station main processor WSC1-L can detect and upload Total Solar Radiation to the IoT Server via wireless LoRaWAN protocol.
60.3	1260	)))
2.2	1261
	1262
3.7	1263	=== 6.6.1 Feature ===
	1264
91.14	1265
2.2	1266	* RS485 Total Solar Radiation sensor
	1267	* Measure Total Radiation between 0.3～3μm（300～3000nm）
	1268	* Measure Reflected Radiation if sense area towards ground.
	1269
3.7	1270	=== 6.6.2 Specification ===
	1271
91.14	1272
2.2	1273	* Input Power: DC 5 ~~ 24v
	1274	* Interface: RS485
	1275	* Detect spectrum: 0.3～3μm（300～3000nm）
	1276	* Measure strength range: 0～2000W/m2
	1277	* Resolution: 0.1W/m2
	1278	* Accuracy: ±3%
	1279	* Yearly Stability: ≤±2％
	1280	* Cosine response: ≤7％ (@ Sun angle 10°)
	1281	* Temperature Effect: ±2％（－10℃～40℃）
	1282	* Working Temperature: -40℃～70℃
	1283	* Working Humidity: 10～90%RH
	1284	* Power Consumption: 4mA @ 12v
	1285
3.7	1286	=== 6.6.3 Dimension ===
	1287
91.14	1288
104.10	1289	[[image:1656057348695-898.png]]
2.2	1290
	1291
3.7	1292	=== 6.6.4 Pin Mapping ===
2.2	1293
91.14	1294
104.10	1295	[[image:1656057359343-744.png]]
2.2	1296
	1297
3.7	1298	=== 6.6.5 Installation Notice ===
2.2	1299
91.14	1300
2.2	1301	Do not power on while connect the cables. Double check the wiring before power on.
	1302
91.14	1303
104.10	1304	[[image:1656057369259-804.png]]
2.2	1305
64.3	1306
104.10	1307	[[image:1656057377943-564.png]]
2.2	1308
	1309
3.7	1310	== 6.7 PAR (Photosynthetically Available Radiation) ~-~- WSS-07 ==
	1311
64.3	1312
	1313	(((
2.2	1314	WSS-07 photosynthetically active radiation sensor is mainly used to measure the photosynthetically active radiation of natural light in the wavelength range of 400-700nm.
64.3	1315	)))
2.2	1316
64.3	1317	(((
2.2	1318	WSS-07 use precision optical detectors and has an optical filter of 400-700nm, when natural light is irradiated, a voltage signal proportional to the intensity of the incident radiation is generated, and its luminous flux density is proportional to the cosine of the direct angle of the incident light.
64.3	1319	)))
2.2	1320
64.3	1321	(((
	1322	WSS-07 is designed to support the Dragino Weather station solution. Users only need to connect WSS-07 RS485 interface to WSC1-L. The weather station main processor WSC1-L can detect and upload Photosynthetically Available Radiation to the IoT Server via wireless LoRaWAN protocol.
	1323	)))
2.2	1324
	1325
3.7	1326	=== 6.7.1 Feature ===
2.2	1327
91.14	1328
79.14	1329	(((
68.2	1330	PAR (Photosynthetically Available Radiation) sensor measure 400 ~~ 700nm wavelength nature light's Photosynthetically Available Radiation.
79.16	1331	)))
2.2	1332
79.14	1333	(((
2.2	1334	When nature light shine on the sense area, it will generate a signal base on the incidence radiation strength.
79.16	1335	)))
2.2	1336
	1337
3.7	1338	=== 6.7.2 Specification ===
	1339
91.14	1340
2.2	1341	* Input Power: DC 5 ~~ 24v
	1342	* Interface: RS485
	1343	* Response Spectrum: 400～700nm
	1344	* Measure range: 0～2500μmol/m2•s
	1345	* Resolution: 1μmol/m2•s
	1346	* Accuracy: ±2%
	1347	* Yearly Stability: ≤±2％
	1348	* Working Temperature: -30℃～75℃
	1349	* Working Humidity: 10～90%RH
	1350	* Power Consumption: 3mA @ 12v
	1351
3.7	1352	=== 6.7.3 Dimension ===
	1353
91.14	1354
104.10	1355	[[image:1656057538793-888.png]]
2.2	1356
	1357
3.7	1358	=== 6.7.4 Pin Mapping ===
	1359
91.14	1360
104.10	1361	[[image:1656057548116-203.png]]
2.2	1362
	1363
3.7	1364	=== 6.7.5 Installation Notice ===
2.2	1365
91.14	1366
2.2	1367	Do not power on while connect the cables. Double check the wiring before power on.
	1368
	1369
104.10	1370	[[image:1656057557191-895.png]]
2.2	1371
	1372
104.10	1373	[[image:1656057565783-251.png]]
2.2	1374
68.2	1375
2.3	1376	= 7. FAQ =
2.2	1377
2.3	1378	== 7.1 What else do I need to purchase to build Weather Station? ==
	1379
91.14	1380
2.2	1381	Below is the installation photo and structure:
	1382
91.14	1383
104.10	1384	[[image:1656057598349-319.png]]
2.2	1385
	1386
104.10	1387	[[image:1656057608049-693.png]]
2.2	1388
	1389
2.3	1390	== 7.2 How to upgrade firmware for WSC1-L? ==
2.2	1391
91.14	1392
70.2	1393	(((
2.2	1394	Firmware Location & Change log:
91.14	1395
	1396	[[https:~~/~~/www.dropbox.com/sh/fuorz31grv8i3r1/AABmjFDU4FADNP6sq7fsmBwVa?dl=0>>https://www.dropbox.com/sh/fuorz31grv8i3r1/AABmjFDU4FADNP6sq7fsmBwVa?dl=0]]
70.2	1397	)))
2.2	1398
	1399
70.2	1400	(((
	1401	Firmware Upgrade instruction: [[Firmware Upgrade Instruction>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome\|\|anchor="H2.HardwareUpgradeMethodSupportList"]]
	1402	)))
2.2	1403
	1404
2.3	1405	== 7.3 How to change the LoRa Frequency Bands/Region? ==
2.2	1406
91.14	1407
70.2	1408	User can follow the introduction for how to [[upgrade image>>\|\|anchor="H7.2HowtoupgradefirmwareforWSC1-L3F"]]. When download the images, choose the required image file for download.
2.2	1409
	1410
2.3	1411	== 7.4 Can I add my weather sensors? ==
2.2	1412
91.14	1413
70.4	1414	Yes, connect the sensor to RS485 bus and see instruction: [[add sensors.>>\|\|anchor="H3.3AddorDeleteRS485Sensor"]]
2.2	1415
	1416
98.1	1417	== 7.5 Where can i find the modbus command for the WSS sensors? ==
	1418
104.12	1419
98.1	1420	See this link for the [[modbus command set>>https://www.dropbox.com/s/rw90apbar029a4w/Weather_Sensors_Modbus_Command_List.xlsx?dl=0]].
	1421
	1422
3.2	1423	= 8. Trouble Shooting =
2.2	1424
70.6	1425	== 8.1 AT Command input doesn't work ==
2.2	1426
91.14	1427
70.6	1428	(((
	1429	In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:green" %)ENTER(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)ENTER(%%) while press the send key, user need to add ENTER in their string.
	1430	)))
2.2	1431
	1432
2.3	1433	= 9. Order Info =
2.2	1434
2.3	1435	== 9.1 Main Process Unit ==
2.2	1436
91.14	1437
34.6	1438	Part Number: (% style="color:blue" %)WSC1-L-XX
2.2	1439
34.6	1440	(% style="color:blue" %)XX(%%): The default frequency band
2.2	1441
34.6	1442	* (% style="color:red" %)AS923(%%): LoRaWAN AS923 band
	1443	* (% style="color:red" %)AU915(%%): LoRaWAN AU915 band
	1444	* (% style="color:red" %)EU433(%%): LoRaWAN EU433 band
	1445	* (% style="color:red" %)EU868(%%): LoRaWAN EU868 band
	1446	* (% style="color:red" %)KR920(%%): LoRaWAN KR920 band
	1447	* (% style="color:red" %)US915(%%): LoRaWAN US915 band
	1448	* (% style="color:red" %)IN865(%%): LoRaWAN IN865 band
	1449	* (% style="color:red" %)CN470(%%): LoRaWAN CN470 band
2.2	1450
2.3	1451	== 9.2 Sensors ==
2.2	1452
91.14	1453
104.12	1454	(% border="1" cellspacing="10" style="background-color:#f2f2f2; width:500px" %)
	1455	\|=(% style="width: 300px;background-color:#D9E2F3;color:#0070C0" %)Sensor Model\|=(% style="width: 200px;background-color:#D9E2F3;color:#0070C0" %)Part Number
	1456	\|(% style="width:462px" %)Rain Gauge\|(% style="width:120px" %)WSS-01
	1457	\|(% style="width:462px" %)Rain Gauge installation Bracket for Pole\|(% style="width:120px" %)WS-K2
	1458	\|(% style="width:462px" %)Wind Speed Direction 2 in 1 Sensor\|(% style="width:120px" %)WSS-02
	1459	\|(% style="width:462px" %)CO2/PM2.5/PM10 3 in 1 Sensor\|(% style="width:120px" %)WSS-03
	1460	\|(% style="width:462px" %)Rain/Snow Detect Sensor\|(% style="width:120px" %)WSS-04
	1461	\|(% style="width:462px" %)Temperature, Humidity, illuminance and Pressure 4 in 1 sensor\|(% style="width:120px" %)WSS-05
	1462	\|(% style="width:462px" %)Total Solar Radiation Sensor\|(% style="width:120px" %)WSS-06
	1463	\|(% style="width:462px" %)PAR (Photosynthetically Available Radiation)\|(% style="width:120px" %)WSS-07
2.2	1464
2.3	1465	= 10. Support =
2.2	1466
91.14	1467
2.2	1468	* Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
96.3	1469
94.2	1470	* Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:file:///D:/市场资料/说明书/LoRa/LT系列/support@dragino.com]].
2.2	1471
2.3	1472	= 11. Appendix I: Field Installation Photo =
2.2	1473
	1474
104.10	1475	[[image:1656058346362-132.png\|\|height="685" width="732"]]
2.2	1476
91.14	1477	(% style="color:blue" %)Storage Battery: 12v,12AH li battery
2.2	1478
	1479
74.2	1480
91.14	1481	(% style="color:blue" %)Wind Speed/Direction
2.2	1482
104.10	1483	[[image:1656058373174-421.png\|\|height="356" width="731"]]
2.2	1484
	1485
74.2	1486
91.14	1487	(% style="color:blue" %)Total Solar Radiation sensor
2.2	1488
104.10	1489	[[image:1656058397364-282.png\|\|height="453" width="732"]]
2.2	1490
	1491
	1492
91.14	1493	(% style="color:blue" %)PAR Sensor
2.2	1494
104.10	1495	[[image:1656058416171-615.png]]
2.2	1496
	1497
74.2	1498
91.14	1499	(% style="color:blue" %)CO2/PM2.5/PM10 3 in 1 sensor
2.2	1500
104.10	1501	[[image:1656058441194-827.png\|\|height="672" width="523"]]
2.2	1502
	1503
77.2	1504
91.14	1505	(% style="color:blue" %)Rain / Snow Detect
2.2	1506
104.10	1507	[[image:1656058451456-166.png]]
2.2	1508
	1509
77.2	1510
91.14	1511	(% style="color:blue" %)Rain Gauge
2.2	1512
104.10	1513	[[image:1656058463455-569.png\|\|height="499" width="550"]]
91.14	1514
	1515

Wiki source code of WSC1-L-Dragino LoRaWAN Weather Station User Manual

Applications