background image

 

 

S76G/S78G Commands Set Reference 

 

v1.6.5 
 
July 2, 2018 
21 of 73 

Product Name   

 

Version 

Doc No 

Date 
Page 

 

3.2

 

  MAC commands 

3.2.1

 

mac tx <Type> <PortNum> <Data>

 

<Type>: a string representing type of transmitting message, it can be 

cnf

 (confirmed) or 

ucnf

 

(unconfirmed). 

<PortNum>:  a  decimal  string  representing  port  number  used  for  transmission,  it  can  be  from 

1

  to 

223

<Data>: a hexadecimal string representing data to be transmitted. 

(e.g. 

98ba34fd means “0x98, 0xba, 0x34, 0xfd 4bytes would be sent out”)

 

 

Response: there are two responses after entering this command. The first response will be received 

after entering command. The second response will be received after transmission. 

 

First response: 

Ok

, if <Type>, <PortNum> and <Data> strings are valid. 

Invalid

, if <Type>, <PortNum> and <Data> strings are not valid. 

not_joined

, module is not joined LoRaWAN

TM

.   

no_free_ch

, no channels are available.   

busy

, internal state is busy. 

invalid_data_length

, data length is larger than the allowed length by LoRaWAN

TM

exceeded_data_length

, data length is larger than 250 bytes. 

 

Second response: 

tx_ok

, successfully transmit data. 

mac rx

 

<portnum> <data>

, there is downlink data. 

<portnum>

 - a decimal string representing receiving port 

<data>

 - a hexadecimal string representing received data. 

err

, acknowledgement is not received, if confirmed message is used. 

 

Purpose: Star transmission by following LoRaWAN

TM 

uplink format. 

 

Example: 

mac tx ucnf 15 98ba34fd 

>> Ok 

>> tx_ok 

mac tx ucnf 15 6805 

>> Ok 

>> mac rx 4 1234abcd 

Summary of Contents for S76G

Page 1: ...S76G S78G Commands Set Reference v1 6 5 July 2 2018 0 of 73 Product Name Version Doc No Date Page Document Name Version Doc No Date S76G S78G Commands Set Reference v1 6 5 July 2 2018 ...

Page 2: ...ac get_batt mac set_tx_confirm mac get_tx_confirm 2 new commands sip sleep sip set_baudrate 5 CLAA commands mac set_claa mac get_claa mac set_getchinfo mac set_gettimeinfo mac set_jumboframe 8 new commands v1 2 0 sip get_hw_model_ver sip set_gpio_mode sip set_gpio sip get_gpio rf fsk rf lora_tx_start rf lora_tx_stop rf lora_rx_start rf lora_rx_stop 1 new commands v1 2 1 sip get_uuid 7 new commands...

Page 3: ...mmands v1 4 5 mac set_ch_count mac get_ch_count sip set_storage sip get_storage mac set_keys 6 new commands v1 5 5 sip set_iap sip set_iap_mode mac set_tx_interval mac get_tx_interval mac set_rx1_freq mac get_rx1_freq 17 new commands v1 6 0 mac set_auto_join mac get_auto_join rm set_gpio rm set_port_uplink rm set_port_downlink rm set_gpio_switch rm set_adc rm set_adc_switch rm set_mode rm set_trig...

Page 4: ... 3 gps set_satellite_system command adds 1 Correct typo errors do some max min values modification 2 A new command gps set_start 3 IAP related commands are removed 1 7 new commands added v1 6 5 mac set_claa_join_ch mac get_claa_join_ch mac set_realtime_store mac get_realtime_store mac set_csma mac get_csma mac set_endswitchclassacmode 2 Change sip set_baudrate password as correct one to 24399520 f...

Page 5: ...S76G S78G Commands Set Reference v1 6 5 July 2 2018 4 of 73 Product Name Version Doc No Date Page ...

Page 6: ... 3 sip reset 3 1 4 sip get_hw_model 3 1 5 sip set_echo 3 1 6 sip set_log 3 1 7 sip sleep 3 1 8 sip_baudrate 3 1 9 sip_get_hw_model_ver 3 1 10 sip_set_gpio_mode 3 1 11 sip_set_gpio 3 1 12 sip_get_gpio 3 1 13 sip_get_uuid 3 1 14 sip set_storage 3 1 15 sip get_storage 3 1 16 sip set_batt_resistor 3 1 17 sip get_batt_resistor 3 1 18 sip get_batt_volt 3 2 MAC commands 3 2 1 mac tx 3 2 2 mac join 3 2 3 ...

Page 7: ...3 2 19 mac set_ch_freq 3 2 20 mac set_ch_dr_range 3 2 21 mac set_ch_status 3 2 22 mac set_dc_ctl 3 2 23 mac set_dc_band 3 2 24 mac set_join_ch 3 2 25 mac set_upcnt 3 2 26 mac set_downcnt 3 2 27 mac set_class 3 2 28 mac get_devaddr 3 2 29 mac get_deveui 3 2 30 mac get_appeui 3 2 31 mac get_nwkskey 3 2 32 mac get_appskey 3 2 33 mac get_appkey 3 2 34 mac get_dr 3 2 35 mac get_band 3 2 36 mac get_powe...

Page 8: ... set_lbt 3 2 57 mac get_lbt 3 2 58 mac set_uplink_dwell 3 2 59 mac get_uplink_dwell 3 2 60 mac set_downlink_dwell 3 2 61 mac get_downlink_dwell 3 2 62 mac set_max_erip 3 2 63 mac get_max_erip 3 2 64 mac set_ch_count 3 2 65 mac get_ch_count 3 2 66 mac set_keys 3 2 67 mac set_tx_interval 3 2 68 mac get_tx_interval 3 2 69 mac set_rx1_freq 3 2 70 mac get_rx1_freq 3 2 71 mac set_auto_join 3 2 72 mac ge...

Page 9: ... 3 5 7 gps get_mode 3 5 8 gps get_data 3 5 9 gps sleep 3 5 10 gps get_ttff 3 5 11 gps reset 3 5 12 gps set_satellite_system 3 5 13 gps_set_start 4 Example 4 1 LoRaWANTM 4 1 1 ABP 4 1 2 OTAA 4 1 3 Confirmed Uplink and Downlink 4 2 GPS Mode 4 4 1 GPS Manual Mode 4 4 2 GPS Auto Mode 4 4 3 Enter Leave GPS Sleep 4 4 4 Get GPS TTFF Value 4 4 5 GPS Reset ...

Page 10: ...gnals for positioning This product is designed with multiple easy to use interfaces I2C SPI UART GPIO fine tuned RF performance and will be offered with complete SDK library ready to go HDK it can significantly help the users to shrink the size of end device and simplify the development efforts for any LoRa R applications For faster development AcSiP provides an EKB named EK S76GXB The EKB equips ...

Page 11: ...other MCU as shown in Figure 2 1 or by connecting micro USB port directly to PC NB as shown in Figure 2 2 The control commands can be sent from PC or other MCU to S76G S78G Figure 2 1 Figure2 2 2 2 Software Configuration The default baud rate of S76G S78G UART1 is set at 115200 And the rest of UART1 setting please follow these below settings Baud rate 115200 Data bits 8 Stop bits 1 Parity none Flo...

Page 12: ...PC NB By using win7 win10 the UART To USB bridge IC driver could be installed automatically and shows a USB serial com port after connecting well between EVB and PC NB via USB cable After successful installation of USB driver you can use any terminal program suggesting free terminal software termite to connect to EVB The commands set can be used through the terminal program By using termite or oth...

Page 13: ...rts to accept command if the string starts from these sip mac and gps prefixes and the response string from S76G S78G starts with two characters and one space For example the first line of the below demo is a module command and the second line is the response from S76G S78G sip get_ver v1 0 8 3 1 SIP commands 3 1 1 sip factory_reset Response A string representing firmware version Purpose All LoRaW...

Page 14: ...en input output Response Ok if Status string is valid Invalid if Status string is not valid Purpose Select which level when logs show Example sip set_log info Ok 3 1 7 sip sleep Time Interruptible Time A decimal string representing S76G S78G sleep time in seconds it can be assigned from 10 to 604800 and the input value must be the multiple of 10 Interruptible During the period of sleep mode it can...

Page 15: ...s of rate 9600 19200 57600 and 115200 password A decimal string representing password that provides baudrate protection This baudrate setting command can only be delivered when password is correct And the assigned baudrate setting would be stored in EEPROM and would not be changed by sip factory_reset command Response Ok if Status string is valid Invalid if Status string is not valid Purpose Chang...

Page 16: ...nvalid if input argument are not valid or out of range Purpose Assign STM32 GPIO pin mode as input or output Example Set PA_0 as output mode sip set_gpio_mode A 0 1 Ok 3 1 11 production verification sip set_gpio Gpio_Group Gpio_Pin_Number Gpio_Value Gpio_Group A string representing STM32 GPIO pin groups it can be these characters A B C D E F and H note no G Gpio_Pin_Number A decimal string represe...

Page 17: ...nt are not valid or out of range Purpose Get the pin state from the assigned GPIO pin Example get PA_2 pin state sip get_gpio A 2 1 3 1 13 production verification sip get_uuid Response A string representing hardware STM32L0 MCU UUID 96 bit value Purpose Each STM32 MCU device has its own unique UUID use this command to read it out Example sip get_uuid uuid 002400413630373619473630 3 1 14 sip set_st...

Page 18: ... length not match with what it comes from sip get_storage it could be using a different FW version between set get commands AES decrption error AES execution error occurs Invalid if anything is wrong in executing this command Example 3 1 15 sip get_storage Purpose To overwrite whole EEPROM data in just one time after caller gets EEPROM encrypted data by using this commands it allows to overwrite o...

Page 19: ...stor R1 R2 R1 A decimal string representing the resistance value ohm of resistor R1 see the below figure it must be greater than 0 and less or equal than 2 24 16777216 16M R2 A decimal string representing the resistance value ohm of resistor R1 see the below figure it must be greater than 0 and less or equal than 2 24 16777216 16M ...

Page 20: ...s equal or low than 3 3v can be measured correctly by S7XX ADC Steps for measure Vbat a To implement a voltage divider circuit And the recommended resistance values of R1 R2 are around 100K 200K respectively b The end point of Vadc is needed to be connected with PB_1 of S7XS GPIO c To measure the resistance value of these two R1 R2 by a resistance meter d To let S7X know the measured R1 R2 values ...

Page 21: ...xternal voltage i e Vbat the maximum input voltage value Vadc of S7XS ADC can t exceed 3 3V Example sip get_batt_volt adc volt 2807 mv battery volt 4197 mv b R1 R2 Not Set Response Return ADC voltage only if R1 R2 didn t set by calling sip set_batt_resistor Purpose The external voltage can be attached with S7XS GPIO PB_1 pin directly when the maximum external voltage is not more than 3 3 volt Exam...

Page 22: ...nse will be received after transmission First response Ok if Type PortNum and Data strings are valid Invalid if Type PortNum and Data strings are not valid not_joined module is not joined LoRaWANTM no_free_ch no channels are available busy internal state is busy invalid_data_length data length is larger than the allowed length by LoRaWANTM exceeded_data_length data length is larger than 250 bytes ...

Page 23: ...ropriately will be received after entering command The second response will be received after join procedure First response Ok if Mode string is valid Invalid if Mode string is not valid keys_not_init keys are not configured no_free_ch no channels are available busy internal state is busy Second response accepted successfully join LoRaWANTM unsuccess join procedure is unsuccessful Purpose Start jo...

Page 24: ...pose Next packet sent to server will include a Link Check MAC command The downlink of sent packet will contain the response of Link Check MAC command The response includes DemoMargin link margin in dB of the last successfully received Link Check MAC command value from 0 to 255 NbGateways gateway number that successfully received the last Link Check MAC command value from 0 to 255 Example mac set_l...

Page 25: ...peui 0000000000000000 Ok Note This assigned AppEUI would be stored into EEPROM immediately after it is changed No need to use mac save command to store it and it would NOT be changed to default value by sip factory_reset command 3 2 8 mac set_appkey AppKey AppKey a 16 byte hexadecimal string representing Application Key used for LoRaWANTM Response Ok if AppKey string is valid Invalid if AppKey str...

Page 26: ...is not valid Purpose Set Network Session Key used for LoRaWANTM Example mac set_nwkskey 703af95b0ea9194771f82f3794ccf18f Ok Note This assigned NwkSKey would be stored into EEPROM immediately after it is changed No need to use mac save command to store it and it would NOT be changed to default value by sip factory_reset command 3 2 11 mac set_appskey AppSessionKey AppSessionKey a 16 byte hexadecima...

Page 27: ...resenting data rate used for LoRaWAN it can be from 0 to 6 US915 is limited from 0 to 4 CN470 is limited from 0 to 5 Response Ok if DataRate string is valid Invalid if DataRate string is not valid Purpose Set uplink s data rate used for LoRaWANTM Example mac set_dr 0 Ok 3 2 14 mac set_adr State State a string representing whether ADR is on or off Response Ok if State string is valid Invalid if Sta...

Page 28: ...representing data rate of second receive window it can be 0 to 7 EU868 or AS923 0 to 5 CN470 0 to 15 US915 Frequency a decimal string representing operation frequency of specified channel in Hz it can be from 902000000 to 932000000 US915 from 470000000 to 510000000 CN470 from 433000000 to 932000000 Other regions Response Ok if DataRate and Frequency strings are valid Invalid if DataRate and Freque...

Page 29: ...lId a decimal string representing channel number its value range depends on different regional band it can be 0 to 15 EU868 or AS923 0 to 95 CN470 or 0 to 71 US915 MinDR a string representing minimum data rate it can be from 0 when uplink dwell is on 2 when downlink dwell is off MaxDR a string representing maximum data rate it would be 6 for EU868 or AS923 5 for CN470 and 4 for US915 Response Ok i...

Page 30: ...to 15 for EU868 or AS923 0 for US915 or CN470 DutyCycle a decimal string representing duty cycle of specified band it can be from 0 to 65535 0 means 0 1 65535 duty cycle is equal to 1 duty cycle Response Ok if BandID and DutyCycle strings are valid Invalid if BandID and DutyCycle strings are not valid Purpose Set frequency range and duty cycle of specified band Example mac set_dc_band 1 100 Ok 3 2...

Page 31: ...r it can be from 0 to 4294967295 Response Ok if DownlinkCounter string is valid Invalid if DownlinkCounter string is not valid Set downlink counter that will be used for next downlink reception Example mac set_downcnt 1 Ok 3 2 27 mac set_class Class Class A or C Response Ok if Class is valid Invalid if Class is not valid already_joined if this command executes after joined either by OTAA or ABP Pu...

Page 32: ...ring representing Network Session Key used for LoRaWANTM Purpose Return Network Session Key used for LoRaWANTM Note The middle part of 10 bytes is masked as star characters for safety reason Example mac get_nwkskey 703af9 ccf18f 3 2 32 mac get_appskey Response a hexadecimal string representing Application Session Key used for LoRaWANTM Purpose Return Application Session Key used for LoRaWANTM Note...

Page 33: ...n it can be 470 868 915 and 923 Purpose Get current frequency list name Example mac get_band 915 3 2 36 mac get_power Response a decimal string representing transmitting power in dBm Purpose Return transmitting power Example mac get_power 14 3 2 37 mac get_adr Response a string representing whether ADR is on or off Return the state of ADR Purpose Returned string can be on off Example mac get_adr o...

Page 34: ... data rate and operation frequency used for second receive window Example mac get_rx2 0 868000000 3 2 41 mac get_sync Response a hexadecimal string representing current sync word Default 34 Purpose Return current sync word used for LoRaWANTM communication Example mac get_sync 12 3 2 42 mac get_ch_para ChannelId ChannelId a decimal string representing channel number its value range depends on diffe...

Page 35: ... falls in 0 to 15 US915 range falls in 0 to 71 Response on or off state of specified channel Invalid if ChannelId string is not valid Purpose Get state of specified channel on means the channel is enabled and off means the channel is disabled Example mac get_ch_status 0 on 3 2 44 mac get_dc_ctl Response state of duty cycle on or off Default off Purpose Get state of duty cycle checking on means the...

Page 36: ... Cycle 0 100 1 1 100 1 2 1000 0 1 3 10 10 4 100 1 5 1 100 6 1 100 7 1 100 8 1 100 9 1 100 10 1 100 11 1 100 12 1 100 13 1 100 14 1 100 15 0 0 Example mac get_dc_band 2 1000 3 2 46 mac get_join_ch Response a list of channel ID for join request Default 0 1 and 2 Purpose Get frequency channel ID for join request The default channel ID for join request is 0 1 and 2 Example mac get_join_ch 0 1 2 3 2 47...

Page 37: ...cle A string representing TX signal would be sent continuously or not it can be cycle or no_cycle Response Ok if Cycle string is valid Invalid if Cycle string is not valid Purpose no_cycle mode means no any TX signal would be sent after joining user needs to send TX signal manually by mac tx command cycle mode allows TX signal keep running but the TX interval is assigned by other duty cycle relate...

Page 38: ... of LoRaWANTM alliance Example mac get_batt 254 3 2 54 mac set_tx_confirm Confirm Confirm A string representing whether S76G TX uplink needs server s ACK in downlink it can be on or off Response Ok if Confirm string is valid Invalid if Confirm string is not valid Purpose Every uplink from devices like S76 78S can request the following downlink whether includes ACK filed So user can use this comman...

Page 39: ...ng or normal uplinks If the channel is occupying S76G S78G would skip to another channel and LBT again until it finds an available channel Example mac set_lbt on Ok sip set_log debug Ok mac tx cnf 3 11223344 CAD found at 868100000 rssi is 30 dBm It means it found the symbol RSSI is too strong at 868 1MHz it must be small than 80dBm Change to another channel and LBT again CAD found at 868300000 rss...

Page 40: ...ng for AS923 band it would be on or off Purpose See mac set_uplink_dwell command Example mac get_uplink_dwell off 3 2 60 mac set_downlink_dwell DownlinkDwell UplinkDwell A string representing DownlinkDwell defined in LoRaWANTM v1 0 2 it can be on or off On means 400ms limit and off means no limit Response Ok if DownlinkDwell string is valid Invalid if DownlinkDwell string is not valid Default valu...

Page 41: ...egion The relationship of MaxEIRP index and corresponding MaxEIRP is as following table Index 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 MaxEIRP dBm 8 10 12 13 14 16 18 20 21 24 26 27 29 30 33 36 Note Only useful for AS923 EU868 CN470 Example mac set_max_eirp 4 Ok 3 2 63 mac get_max_eirp Response A decimal string representing the current MaxEIRP index setting for certain band it would be 0 to 15 Purpos...

Page 42: ...mac get_ch_count Response A decimal string representing the current enabled channels counts its range would be from 0 to 96 Purpose See mac set_ch_count command Example mac get_ch_count 8 3 2 66 mac set_keys DevAddr DevEUI AppEUI AppKey AppsKey NwksKey DevAddr it follows mac set_devaddr command input format DevEUI it follows mac set_deveui command input format AppEUI it follows mac set_appeui comm...

Page 43: ...ne or two keys Not all 6 keys caller can let the rest of keys be 0 The 0 value of a certain key would not be modified e g the below shows DevEUI AppKey and AppsKey won t be modified others are updated and also stored into EEPROM Incorrect examples Any incorrect input parameters occur the value of keys would NOT be updated into EEPROM ...

Page 44: ...ring representing TX LoRaWAN Uplink interval ms it can be between 5000 to 86400000 Response Ok if Interval string is valid Invalid if Interval string is not valid Default value is 5000 Purpose User can assign the interval between two TXs LoRaWAN Uplinks when it s under tx cycle mode and the duty cycle control is turned off Example mac set_tx_mode cycle Ok ...

Page 45: ...r region 0 value can let Tx Rx1 frequency be set back to the identical frequency value Rx1 would follow the mac set_ch_freq value same as Tx1 frequency Rx1_Step a decimal string representing the incremental frequency step it can be assigned from 0 to 600000 The normal usage is 20000 when BW is set at 125KHz Rx1_Count a decimal string representing the RX1 channels count it can t exceed the maximum ...

Page 46: ...x1_freq 500300000 200000 8 Ok List the result of setting above mac get_ch_para 0 470300000 0 5 0 500300000 mac get_ch_para 1 470500000 0 5 0 500500000 mac get_ch_para 2 470700000 0 5 0 500700000 mac get_ch_para 3 470900000 0 5 0 500900000 mac get_ch_para 4 471100000 0 5 0 501100000 mac get_ch_para 5 471300000 0 5 0 501300000 mac get_ch_para 6 471500000 0 5 0 501500000 mac get_ch_para 7 471700000 0...

Page 47: ...representing whether auto join mode is on or off Response Ok if Swtich string is valid Invalid if Switch string is not valid Join_Type A string representing the selected join type of LoRaWAN it can be otaa over the air activation or abp activation by personalization Join_Count If Join_Type is selected as otaa Join_Count can be 1 to 65535 and its meaning is the re try times of OTAA when it s failed...

Page 48: ...ining mac set_auto_join on abp Ok Disable Auot Join behavior mac set_auto_join off Ok Don t forget to save the settings or it would not take effect after reboot mac save Ok 3 2 72 mac get_auto_join Response To indicate the current setting of auto join mode please see the below demo example Purpose See mac set_auto_join command Example mac set_auto_join on otaa 3 Ok mac get_auto_join otaa 3 mac set...

Page 49: ...ing power index TXPower it can be 0 to 7 non 915 band 0 to 10 915 band Response Ok if Power string is valid Invalid if Power string is not valid Purpose Set transmitting power index value See the diagram below Example mac set_power_index 3 Ok 3 2 74 mac get_power_index Response a decimal string representing transmitting power index value Purpose Return transmitting power index value Example mac ge...

Page 50: ...he next boot up value without sending mac save command Example gps set_level_shift on Ok More demonstration examples please refer to chapter 4 4 3 3 2 gps set_nmea Sentence Sentence A string representing which NMEA sentence S76G is selected currently on this version it only can be rmc Recommended Minimum Specific GNSS Data Response Ok if Sentence string is valid Invalid if Sentence string is not v...

Page 51: ...if input argument is valid Invalid if input argument is not valid or out of range Port value would be stored into EEPROM immediately for keeping the next boot up value without sending mac save command Exampe To use LoRaWAN port 20 as uplink port gps set_port_uplink 20 Ok More demonstration examples please refer to chapter 4 4 3 3 4 gps set_format_uplink Format Format A string representing the form...

Page 52: ...1 20 c 01 North is 0x01 South is 0x00 d 18 260e0900 0x18 24 0x00090e26 593446 So Latitude is 24 59 3446 GPS RMC Data not DD or DMS format e 01 East is 0x01 West is 0x00 f 79 0000 1ad30200 0x79 121 0x0000 Not Used 0x0002d31a 185114 So Longitude is 121 18 5114 GPS RMC Data not DD or DMS format g 0400 0x0004 Speed over ground is 0 4 knot h b504 0x04b5 Course over ground is 120 5 i 01000000 0x00000001...

Page 53: ...MC Data 3446 60 10000 20 67 So GPS DMS value is 24o 59 20 67 Format is ipso The uploaded data length is 11 bytes Reference link https mydevices com cayenne docs lora Format is kiwi The uploaded data length is 17 bytes and its format is not allowed to be disclosure here But S76G v1 6 2 g6 is already verified and compatible with Kiwi LoRaWAN Server Example gps set_format_uplink raw Ok Format is utc_...

Page 54: ...0 00 1100 1110 1100 1011 b Find UTC Date out Add 0 in front of 0100 10 it becomes 00010010 00010010 is 0x12 hex value 0x12 hex is 18 decimal so the Day of date is 18 Year Month is not supporting c Find UTC Time out Add 0 in front of 00 1100 1110 1100 1011 it becomes 0000 1100 1110 1100 1011 0000 1100 1110 1100 1011 is 0x0cecd hex value 0x0cecb hex is 52939 52939 means 5 29 39 5 hour 29 minute 39 s...

Page 55: ...62 0xc83b5b62 hex 1100 1000 0011 1011 0101 1011 0110 0010 b East or West Bit31 indicates it s showing East or West 1 E 0 W c Calculate Latitude as DD decimal degree format So change Bit31 Bit30 as 0 0000 1110 1010 1000 1001 1011 1100 0110 0xc83b5b62 becomes 0x483b5b62 and its decimal value is 1211849570 1211849570 10 7 121 deg 1211849570 Modulo 10 7 1849570 1849570 100000 18 49570 minute 18 49570 ...

Page 56: ...l mode is called it would start to try to initialize GPS by the given NMEA sentence and positioning cycle time that set before c So it is recommended to call gps set_nmea gps set_positioning_cycle before calling this command or it would just return invalid response d When Idle mode is assigned it lets GPS stop positioning and back to GPS IDLE mode Example gps set_mode auto Ok gps set_iap_mode manu...

Page 57: ...CXD5603GF returns the UTC and coordinates and positioning time it can be raw dd or dms Purpose When GPS is running at Manual mode by setting gps set_mode manual user can get GPS related data by this command Response a There are several kinds of responses after entering this command When GPS is not initialized yet or entered GPS IDLE mode Example gps get_data dd gps_not_init gps set_mode manual Ok ...

Page 58: ...06 LAT 24 988825 N LONG 121 308326 E POSITIONING 2 9s gps get_data dms To get GPS DMS Degree Minute Second data DMS UTC 2017 11 23 06 59 51 LAT 24 59 1990 N LONG 121 18 2992 E POSITIONING 4 6s d When GPS is not able to positioning by GPS signal is gone it would tell GPS is not able to position Example gps get_data dms gps_not_positioning More demonstration examples please refer to chapter 4 4 3 3 ...

Page 59: ... show the TTFF Time To First Fix value of the last GPS positioning And this value would be reset as 0 0s when S76G S78G boots up reset by sip reset or enter GPS Idle mode by setting gps set_mode idle Example gps get_ttff 5 6s More demonstration examples please refer to chapter 4 4 3 3 11 gps reset Purpose To reset GPS simply it would trigger a SONY CXD5603 reset signal by generating a negative pul...

Page 60: ...senting S76G S78G GPS satellite system is set to either GPS or GPS GLONASS so the string can be gps or hybrid Response Ok if satellite_system string is valid Invalid if satellite_system string is not valid Purpose a GPS is selected by default b The setting value of this command saves into EEPROM immediately after this command executed Example gps get_mode off hot 20 3000 kiwi gps gps set_satellite...

Page 61: ...sip factory_reset the default value is set at hot start c After calling this command the setting value would be stored into EEPROM immediately Example gps set_start cold Ok gps get_mode off cold 20 3000 kiwi gps 4 Example This section gives several complete examples on how to use AcSiP command interface All examples include many comments followed by double slash This comments are for clearly expla...

Page 62: ...Ok Activation by Personalization mac join abp Ok accepted Send unconfirmed uplink on port 15 mac tx ucnf 15 1234 Ok tx_ok 4 1 2 OTAA Set channel frequency channel number and frequency depends on server configuration mac set_ch_freq 0 926500000 Ok mac set_ch_freq 1 926700000 Ok mac set_ch_freq 2 926900000 Ok Set following according to LoRaWAN configuration mac set_deveui 9c65f9fffeabcd12 Ok mac set...

Page 63: ...t_auto_join on otaa 3 The next boot up it would try to join by ABP ABP only needs one time joining mac set_auto_join on abp Disable Auot Join behavior mac set_auto_join off Don t forget to save the last setting above or it would not take effect after reboot mac save Reset node and then Auto Join Mode starts sip reset 4 1 3 Confirmed Uplink and Downlink Send confirmed uplink on port 15 mac tx cnf 1...

Page 64: ...S76G S78G Commands Set Reference v1 6 5 July 2 2018 63 of 73 Product Name Version Doc No Date Page mac tx cnf 15 1234 Ok rx 15 6432 Receive downlink 0x64 0x32 from server on port 15 ...

Page 65: ... _____ _ ____ _____ ___ _ __ ___ __ _ Tech Co LTD ___ __ ___ ____ LoRaWAN v1 0 2 Ready _ _ ___ ____ _ _ Class A C S76G v1 6 1 g6 AS923 Nov 20 2017 10 47 10 gps set_level_shift on Ok gps set_start hot Ok gps set_satellite_system gps Ok gps set_positioning_cycle 5000 Ok gps set_port_uplink 20 Ok gps set_format_uplink ipso Ok gps set_mode manual Ok gps get_mode ...

Page 66: ...IONING 68 4s gps get_data dms POSITIONING 81 3s gps get_data dms POSITIONING 100 6s gps get_data dms DMS UTC 2017 12 27 02 29 25 LAT 24 59 20 50 N LONG 121 18 30 48 E POSITIONING 0 3s gps get_data dms DMS UTC 2017 12 27 02 29 25 LAT 24 59 20 50 N LONG 121 18 30 48 E POSITIONING 1 9s gps get_ttff 103 4s Note GPS UTC DMS Format DMS UTC 2017 12 27 02 29 25 LAT 24 59 20 50 N LONG 121 18 30 48 E POSITI...

Page 67: ...sitioning time Positioning Time 4 2 2 GPS Auto Mode sip reset ___ _____ _ ____ _____ ___ _ __ ___ __ _ Tech Co LTD ___ __ ___ ____ LoRaWAN v1 0 2 Ready _ _ ___ ____ _ _ Class A C S76G v1 6 1 g6 AS923 Nov 20 2017 10 47 10 gps set_level_shift on Ok gps set_start hot Ok gps set_satellite_system gps Ok gps set_positioning_cycle 5000 Ok gps set_format_uplink ipso Ok gps set_port_uplink 20 Ok gps set_mo...

Page 68: ...save Ok mac join otaa It will upload GPS data by LoRaWAN port 20 when GPS is already positioned well 4 2 3 Enter Leave GPS Sleep gps set_mode idle GPS enters IDLE mode and stop positioning Ok gps sleep on 0 GPS enters Sleep mode Ok gps sleep off Ok gps sleep on 1 GPS enters Deep Sleep mode Ok gps sleep off Ok 4 2 4 Get GPS TTFF Value gps set_level_shift on Ok ...

Page 69: ... 7s Still positioning gps get_data dms DMS UTC 2017 12 08 01 34 48 LAT 24 59 21 50 N LONG 121 18 31 00 E POSITIONING 0 7s gps get_data dms DMS UTC 2017 12 08 01 34 51 LAT 24 59 20 27 N LONG 121 18 30 40 E POSITIONING 0 1s gps get_ttff 62 2s Shows the total positioning time from sending the command gps set_mode manual gps set_mode idle Ok GPS enters IDLE mode and stop positioning gps set_mode manua...

Page 70: ...nding the command gps set_mode manual 4 2 5 Reset GPS gps get_data dms DMS UTC 2017 12 08 01 47 48 LAT 24 59 43 42 N LONG 121 18 46 21 E POSITIONING 2 0s gps get_ttff 9 3s gps set_mode idle Ok gps reset Ok Generate a negative pulse pulse width is around 200ms at GPS_RST_X pin to reset SONY CXD5603GF gps set_mode manual Ok Let GPS position again 4 2 6 GPS Auto Mode GPS Auto Join Take Kiwi Server as...

Page 71: ...D ___ __ ___ ____ LoRaWAN v1 0 2 Ready _ _ ___ ____ _ _ Class A C S76G v1 6 2 g7 rc2 AS923 Jan 3 2018 13 11 55 gps set_level_shift on Ok gps set_format_uplink kiwi Ok gps set_port_uplink 3 Ok gps set_start hot Ok gps set_satellite_system gps Ok gps set_positioning_cycle 3000 Ok gps get_mode off hot 3 3000 kiwi gps gps set_mode auto Ok mac set_devaddr 1e000001 Ok ...

Page 72: ... set_adr off Ok mac set_ch_freq 2 923600000 Ok mac set_ch_freq 3 923800000 Ok mac set_ch_freq 4 924000000 Ok mac set_ch_freq 5 924200000 Ok mac set_ch_freq 6 924400000 Ok mac set_ch_freq 7 924600000 Ok mac set_auto_join on otaa 3 Ok gps set_mode auto The setting value would be stored into EEPROM automatically Ok mac save This mac save is used for mac set_auto_join and other mac commands ...

Page 73: ... __ ___ __ _ Tech Co LTD ___ __ ___ ____ LoRaWAN v1 0 2 Ready _ _ ___ ____ _ _ Class A C S76G v1 6 2 g7 rc2 AS923 Jan 3 2018 13 11 55 gps_in_auto join by otaa 3 accepted gps get_ttff 102 6s Starts to upload GPS coordinates data after positioning To disable GPS Auto Mode Auto Join Mode gps set_mode off Ok mac set_auto_join off Ok mac save Ok ...

Page 74: ...1 6 5 July 2 2018 73 of 73 Product Name Version Doc No Date Page sip reset ___ _____ _ ____ _____ ___ _ __ ___ __ _ Tech Co LTD ___ __ ___ ____ LoRaWAN v1 0 2 Ready _ _ ___ ____ _ _ Class A C S76G v1 6 2 g7 rc2 AS923 Jan 3 2018 13 11 55 ...

Reviews: