What is the correct syntax for filtering with the AT+LSCN command?

Answer

When working with the AT Interface firmware, central role devices can filter scan results by using the following optional parameters with the AT+LSCN command.

AT+LSCN (timeout),(escaped pattern), (rssi)

  • timeout_ sec: configures how long the module will scan before it timesout
  • escaped_pattern : filters the adverts in the scan results for a pattern in the Device Name. This is case sensitive.
  • rssi: filters adverts in the scan results based on the RSSI value
  • scan type: Bitmask that sets the type of scan (1MPHY (bit 0 set), LECoded (bit 1 set), Secondary channel scanning (bit 2 set), passive scanning (bit 3 set)

The syntax requires that commas are used to separate each parameter. If not skipping a parameter setting, like "escaped pattern" leave it blank between the commas holding the place for the unused parameter.

Some examples are shown below using a Lyra-S module running the AT Interface firmware:

Example 1: Only setting timeout parameter to 2 seconds

at+lscn 2

AD1:0 003BB937C5B365 -90 ""
ADS:0 003BB937C5B365 -90 "ESLinker-C5B365"
AD1:0 00E2BB9E33B974 -61 ""
ADS:0 00E2BB9E33B974 -61 "ET-3850 Series"
AD1:3 010B16D9226D8C -41 ""
AD1:0 003BB937C5B365 -78 ""
ADS:0 003BB937C5B365 -78 "ESLinker-C5B365"
AD1:0 00E2BB9E33B974 -56 ""
ADS:0 00E2BB9E33B974 -56 "ET-3850 Series"
AD1:0 003BB937C5B365 -78 ""
ADS:0 003BB937C5B365 -78 "ESLinker-C5B365"
AD1:3 01E5ED7A1BA907 -78 ""
AD1:3 010B16D9226D8C -45 ""
AD1:0 003BB937C5B365 -75 ""
ADS:0 003BB937C5B365 -75 "ESLinker-C5B365"
AD1:0 00E2BB9E33B974 -55 ""
ADS:0 00E2BB9E33B974 -55 "ET-3850 Series"
AD1:3 010B16D9226D8C -46 ""
AD1:0 003BB937C5B365 -75 ""
ADS:0 003BB937C5B365 -74 "ESLinker-C5B365"
AD1:3 010B16D9226D8C -46 ""
AD1:0 003BB937C5B365 -89 ""
ADS:0 003BB937C5B365 -89 "ESLinker-C5B365"
AD1:0 00E2BB9E33B974 -61 ""
ADS:0 00E2BB9E33B974 -61 "ET-3850 Series"
AD1:3 010B16D9226D8C -41 ""
AD1:3 010B16D9226D8C -41 ""
AD1:0 003BB937C5B365 -78 ""
ADS:0 003BB937C5B365 -78 "ESLinker-C5B365"
AD1:0 00E2BB9E33B974 -56 ""
ADS:0 00E2BB9E33B974 -56 "ET-3850 Series"
AD1:3 010B16D9226D8C -45 ""
AD1:3 011824EF90B41E -88 ""
AD1:0 003BB937C5B365 -75 ""
ADS:0 003BB937C5B365 -75 "ESLinker-C5B365"
AD1:3 010B16D9226D8C -46 ""
AD1:0 00E2BB9E33B974 -55 ""
ADS:0 00E2BB9E33B974 -55 "ET-3850 Series"
AD1:3 010B16D9226D8C -41 ""
AD1:0 00E2BB9E33B974 -61 ""
ADS:0 00E2BB9E33B974 -61 "ET-3850 Series"
AD1:0 003BB937C5B365 -75 ""
ADS:0 003BB937C5B365 -75 "ESLinker-C5B365"
AD1:0 003BB937C5B365 -90 ""
ADS:0 003BB937C5B365 -90 "ESLinker-C5B365"
AD1:0 0018C293029337 -45 "LYRA-029337"
ADS:0 0018C293029337 -45 ""
AD1:0 00E2BB9E33B974 -61 ""
AD1:3 010B16D9226D8C -45 ""
AD1:0 00E2BB9E33B974 -56 ""
ADS:0 00E2BB9E33B974 -56 "ET-3850 Series"
OK

Example 2: Only setting "escaped pattern" parameter * (uses default timeout parameter set at S Reg 106)

at+lscn ,"LYRA"

AD1:0 0018C293029337 -48 "LYRA-029337"
AD1:0 0018C293029337 -46 "LYRA-029337"
AD1:0 0018C293029337 -51 "LYRA-029337"
AD1:0 0018C293029337 -48 "LYRA-029337"
AD1:0 0018C293029337 -45 "LYRA-029337"
AD1:0 0018C293029337 -51 "LYRA-029337"
AD1:0 0018C293029337 -49 "LYRA-029337"
AD1:0 0018C293029337 -44 "LYRA-029337"
AD1:0 0018C293029337 -53 "LYRA-029337"
AD1:0 0018C293029337 -49 "LYRA-029337"
AD1:0 0018C293029337 -46 "LYRA-029337"
AD1:0 0018C293029337 -53 "LYRA-029337"
AD1:0 0018C293029337 -49 "LYRA-029337"
AD1:0 0018C293029337 -53 "LYRA-029337"
AD1:0 0018C293029337 -49 "LYRA-029337"
AD1:0 0018C293029337 -45 "LYRA-029337"
AD1:0 0018C293029337 -53 "LYRA-029337"
AD1:0 0018C293029337 -49 "LYRA-029337"
AD1:0 0018C293029337 -44 "LYRA-029337"
AD1:0 0018C293029337 -53 "LYRA-029337"
OK

Example 3: Only setting time_out and RSSI parameters

at+lscn 2,,-60

AD1:3 010784D7B7E8C0 -47 ""
AD1:3 010784D7B7E8C0 -46 ""
AD1:3 010784D7B7E8C0 -46 ""
AD1:3 010784D7B7E8C0 -42 ""
AD1:0 00E2BB9E33B974 -57 ""
ADS:0 00E2BB9E33B974 -57 "ET-3850 Series"
AD1:3 010784D7B7E8C0 -47 ""
AD1:0 00E2BB9E33B974 -56 ""
ADS:0 00E2BB9E33B974 -56 "ET-3850 Series"
AD1:3 010784D7B7E8C0 -46 ""
AD1:0 00E2BB9E33B974 -57 ""
ADS:0 00E2BB9E33B974 -57 "ET-3850 Series"
AD1:3 010784D7B7E8C0 -42 ""
AD1:0 00E2BB9E33B974 -57 ""
ADS:0 00E2BB9E33B974 -57 "ET-3850 Series"
AD1:3 010784D7B7E8C0 -46 ""
AD1:0 00E2BB9E33B974 -57 ""
ADS:0 00E2BB9E33B974 -57 "ET-3850 Series"
AD1:3 010784D7B7E8C0 -45 ""
OK


Example 4: Setting scan type parameter to scan for both 1MPHY and LECoded for 1 second


at+lscn 1,,,3

AD1:0 003BB937C5B365 -75 ""
ADS:0 003BB937C5B365 -75 "ESLinker-C5B365"
AD1:0 00E2BB9E33B974 -55 ""
ADS:0 00E2BB9E33B974 -56 "ET-3850 Series"
AD1:3 0113319782410E -79 ""
AD1:0 00E2BB9E33B974 -54 ""
ADS:0 00E2BB9E33B974 -55 "ET-3850 Series"
AD1:0 003BB937C5B365 -75 ""
ADS:0 003BB937C5B365 -75 "ESLinker-C5B365"
AD1:3 011991A5463397 -41 ""
AD1:0 003BB937C5B365 -73 ""
ADS:0 003BB937C5B365 -73 "ESLinker-C5B365"
AD1:3 011991A5463397 -45 ""
AD1:0 00E2BB9E33B974 -58 ""
ADS:0 00E2BB9E33B974 -58 "ET-3850 Series"
AD1:3 011991A5463397 -45 ""
AD1:0 003BB937C5B365 -73 ""
ADS:0 003BB937C5B365 -73 "ESLinker-C5B365"
AD1:0 003BB937C5B365 -84 ""
ADS:0 003BB937C5B365 -84 "ESLinker-C5B365"
AD1:3 011991A5463397 -46 ""
AD1:0 00E2BB9E33B974 -55 ""
ADS:0 00E2BB9E33B974 -55 "ET-3850 Series"
AD1:0 003BB937C5B365 -84 ""
ADS:0 003BB937C5B365 -85 "ESLinker-C5B365"
AD1:3 011991A5463397 -42 ""
AD1:0 003BB937C5B365 -75 ""
ADS:0 003BB937C5B365 -75 "ESLinker-C5B365"
OK