Related Manuals for Swarm Tile
Summary of Contents for Swarm Tile
-
Page 1: Swarm Tile Product Manual
Swarm Tile Product Manual Swarm Tile Product Manual Revision 1.00 June 2020 © 2020 Swarm Technologies, Inc. - Page 2 Legal Notices This User Manual provides user information and is provided “as is.” Swarm Technologies and its affiliated companies, directors, officers, employees, agents, trustees or consultants (“Swarm”) assume no responsibility for any typographical, technical, content or other inaccuracies in this User Manual. Swarm reserves the right to revise this User Manual or withdraw it at any time without prior notice.
- Page 3 Export Compliance The Swarm Tile is controlled by the export laws and regulations of the United States of America. The U.S. Government may restrict the export or re-export of this product to certain individuals and/or destinations.
-
Page 4: Revision History
Revision History Revision Date Comment 0.95 03/16/2020 Tile Product Manual - Initial Release 1.00 6/3/2020 Updated Firmware Commands to reflect version 0.7.3. Improved specifications on Tile mechanical and electrical sections June 2020 Swarm Tile Manual - Rev 1.00 4/63... -
Page 5: Table Of Contents
4.3 DC Power Interface 4.4 Power On/Off Control 4.5 Serial Data Interface 5 RF Interface 5.1 RF Connectors 5.2 RF Connectors 5.2.1 Antenna Characteristics 5.3 RF Trace Layout Design 5.3 Integration Guidance June 2020 Swarm Tile Manual - Rev 1.00 5/63... - Page 6 $GS - GPS Fix Quality $MM - Manage received messages $PO - Power Down $PW - Power Status $RS - Restart Tile $RT - Receive Test $SL - Sleep mode $TD - Transmit data June 2020 Swarm Tile Manual - Rev 1.00 6/63...
-
Page 7: Safety Information And Compliance
1 Safety Information and Compliance The Tile is designed to comply with the standards for Radio Emissions Compliance and Electromagnetic Compatibility in the United States, Canada, Australia, New Zealand, United Kingdom, European Union, as well as worldwide. 1.1 FCC Compliance 1.1.1 FCC Interference Statement (Part 15.105 (b)) -
Page 8: Ised Compliance
1.1.4 FCC ID: The FCC ID for the Tile is 2 AVE9-TILE01 . All manufacturers integrating the Tile into their products are advised to provide a physical or e-label stating “Contains FCC ID: 2 AVE9-TILE01 ” . 1.1.5 Part 15 Subpart B Disclaimer: The final host product requires Part 15B compliance testing with the modular transmitter installed. -
Page 9: Eu Red Certification
1.5 Transceiver Regulatory Certification The Tile is a regulatory approved modular transmitter that is designed to be integrated into an enclosed host system. With appropriate external connections, the host can be designed to meet full regulatory tests and sold as a regulatory certified product that meets FCC, IC, and CE requirements. -
Page 10: Product Overview
IoT applications. Tile is a Surface Mount Technology (SMT) module that can be easily integrated into any new or existing PCB design. The Tile communicates via a standard 3.3V CMOS serial UART interface or a PC interface with a USB-to-serial converter. -
Page 11: Mechanical Specification
3 Mechanical Specification 3.1 Tile Dimensions The overall dimensions of the Tile and its weight are summarized in T able 3 . Parameter Value Length 58.67±0.3 mm Width 27.43±0.3 mm Height 6.00±0.1 mm Weight 14 g Table 3: Tile Mechanical Dimensions and Weight. -
Page 12: Environmental
3.2 Environmental The environmental specifications of the Tile are summarized in T able 4 below. The Tile is not conformally coated, and as such the user needs to provide any weatherproofing for their application. Parameter Value Operating Temperature Range -55 °C to +130 °C... -
Page 13: Reflow Soldering
3.3 Reflow Soldering The Tile is designed to be reflow soldered onto a PCB. A recommended reflow profile can be found below in F igure 3 a nd T able 5 Use of "No Clean" soldering paste is recommended. An example “No Clean” paste can be found... -
Page 14: Physical Interface Connectors
The Tile incorporates two connectors: • A GPS Antenna U.FL male connector [ T E Connectivity #1909763-1 ] • An RF Antenna U.FL male connector [ T E Connectivity #1909763-1 ] June 2020 Swarm Tile Manual - Rev 1.00 14/63... -
Page 15: Electrical Interfaces
● GPIO_1 (optional) 4.2 Tile Pin Allocation The pin numbering scheme of the Tile is shown in Figure 4 . The module pins allow soldering onto a printed circuit board (PCB) using standard reflow soldering techniques. The pin function assignment is given in T ables 6 and 7 . Multiple supply grounds are provided and all supply and supply grounds are required to be connected to the power supply in order to limit the current on any one pin. - Page 16 RESERVED - DO NOT CONNECT Not Connected RESERVED - DO NOT CONNECT Ground Ground Ground Ground Ground Ground SAT_OUT External satellite radio antenna connection Ground Ground Table 6: T ile pin numbers and descriptions. June 2020 Swarm Tile Manual - Rev 1.00 16/63...
- Page 17 50 ohm strip line to the RF connector. 9, 10 The 3.3V connection points are in parallel with one another and power the Tile. If the designer wants to enable a complete power off mode, a load switch can be provided here.
-
Page 18: Dc Power Interface
GPS acquisition mode for approximately 30 seconds after exiting from sleep mode, on powerup, or when the Tile needs to re-acquire a GPS fix (approximately once every 3 hours) while the Tile is continuously powered on and not in sleep mode. - Page 19 Figure 5: Example current use for a Tile with a 3.3 V input from wake-up, GPS acquisition, Transmit, Receive mode, and then sleep mode. Note the two breaks in the y-axis scale. Transmissions from the Tile consist of short periods of high current draw conforming to the...
- Page 20 An example of the interface between a Tile and a third-party host device is shown in F igures 6 and 7 . A photo of a Tile integrated onto a third party device can be found in F igure 8.
- Page 21 Figure 8: S ample hardware reference design integration for Tile. The three programming headers are highly encouraged so that the Tile firmware can be easily updated in the future. June 2020 Swarm Tile Manual - Rev 1.00...
-
Page 22: Power On/Off Control
The Tile can be externally switched on/off by an user-supplied load switch on the 3V3 power rail. After a Tile has been powered off, power should not be restored until more than 1 second has elapsed. Additionally, if a unit does not respond to software commands, power off the module, wait for at least 1 second and then power it back on. -
Page 23: Rf Interface
[ T E Connectivity Part Number 1909763-1 ] . This is a surface mount connector that is directly attached to the Tile. A Swarm VHF antenna must be used to ensure that the RF output is within certification limits. Swarm antennas are tuned for a VSWR of 1.8 or better at both 137 MHz and 150 MHz. -
Page 24: Antenna Characteristics
5.2.1 Antenna Characteristics The Tile is certified with the following antennas as described in T ables 12 a nd 1 3 . No power reduction compensation is required for use with these antennas. Swarm Coiled ¼ Wave Antenna... - Page 25 A GPS antenna is r equired for operation . Any passive GPS antenna with an appropriate connection to the Tile’s U.FL male connector or via the GPS_OUT pin is acceptable for use. One such example of a passive antenna is: ...
-
Page 26: Rf Trace Layout Design
5.3 RF Trace Layout Design The Tile is certified with a PCB edge SMA connectors [ S amtec Part Number SMA-J-P-H-ST-EM1 ] for the RF and GPS outputs, with a micro-strip trace layout (along with copper keep-out areas) as shown in F igure 10 . The thicknesses of the PCB layers is shown in Figure 11... -
Page 27: Integration Guidance
The following recommendations are provided for the host device: ● Place the Tile close to the edge of the host PCB, preferably on a corner ● Use a solid GND plane on an inner layer (for best EMC and RF performance). -
Page 28: Software Interface
If the inter-character delay exceeds 5 ms, the command will be silently discarded, and the receiving state machine will consume and ignore any characters received until the next $ . June 2020 Swarm Tile Manual - Rev 1.00 28/63... - Page 29 NMEA sentence has been received: $TILE BOOT,RUNNING*49 The bootloader may output non-NMEA formatted messages during this time. These messages include, but are not limited to: status messages, firmware update progress messages, and error messages. June 2020 Swarm Tile Manual - Rev 1.00 29/63...
-
Page 30: Unsolicited Messages
6.1 Unsolicited Messages Unsolicited messages may be sent by the Tile to report status information to the user as events occur. These messages never expect any type of response or confirmation $DT - Date/Time Status This unsolicited message indicates the current date/time obtained from GPS. This message is not sent until the GPS has obtained a valid time reference to set its internal date and time, as indicated by the ... -
Page 31: Gj - Gps Jamming/Spoofing Indicator
This unsolicited message provides standard NMEA-formatted positional information, including latitude, longitude, altitude, course, and speed. This message is not sent until the GPS has obtained a valid position fix, as indicated by the $ TILE POSITION*2d message. Geospatial ... -
Page 32: Gs - Gps Fix Quality
This unsolicited message provides a standard NMEA-formatted description of the type of GPS fix currently in use. This message is not sent until the Tile has obtained a valid position fix. GPS fix quality unsolicited messages can be enabled/disabled using the $ GS command. -
Page 33: Pw - Power And Temperature Status
This unsolicited message provides an ASCII-encoded hexadecimal string with the user data received from the Swarm network. Some fields also include signal quality information for the received message. Received data unsolicited messages can be enabled/disabled using the $ MM command with the message notification option. -
Page 34: Rt - Receive Test
$RT - Receive Test This unsolicited message provides reception status information on the Swarm network. When enabled, periodic RSSI reports are provided. Upon reception of a packet from a satellite, additional signal quality information is provided. These messages are provided for initial setup and debugging during installation. -
Page 35: Tile - Tile Status
$TILE - Tile Status These unsolicited status messages indicate the readiness of the Tile for normal operation. This includes the conditions at power up, GPS acquisition, and certain error conditions. Tile status messages cannot be disabled. $TILE <msg>,[<data>]*xx Parameter Description BOOT... -
Page 36: Commands And Responses
Retrieve and display the configuration settings for the Swarm device ID, application ID, emulation mode, and unique ID (UUID). These settings are determined by Swarm for identifying and communicating with each individual device. Since there are no variable parameters, the correct checksum has been added. -
Page 37: Dt - Date/Time
$ DT ? query. <rate> is a value between 1 and 2147483647 (2 31 -1). It will be the number of seconds in between each message. June 2020 Swarm Tile Manual - Rev 1.00 37/63... - Page 38 Calling the most recent date/time message: $DT @*70 $DT 20190408195123,V*6d Returns a date/time of A pril 8th, 2019 7:51:23 PM GMT . The date/time is v alid June 2020 Swarm Tile Manual - Rev 1.00 38/63...
-
Page 39: Fv - Firmware Version
Command input error Notes: An E RR response will be generated if the command is not entered exactly as shown with no additional spaces or characters. Example: $FV*10 $FV 2020-05-19 19:07:33,v0.7.2*7d June 2020 Swarm Tile Manual - Rev 1.00 39/63... -
Page 40: Gj - Gps Jamming/Spoofing Indication
If no comma is present and the value is a number, then the value is the rate being returned in response to the $ GJ ? query. June 2020 Swarm Tile Manual - Rev 1.00 40/63... - Page 41 <rate> is a value between 1 and 2147483647 (2 31 -1). It will be the number of seconds in between each message. Example: Setting the rate for geospatial information messages to 1 per second: $GJ 1*1C $GJ OK*29 June 2020 Swarm Tile Manual - Rev 1.00 41/63...
-
Page 42: Gn - Geospatial Information
$ GN ? query. <rate> is a value between 1 and 2147483647 (2 31 -1). It will be the number of seconds in between each message. June 2020 Swarm Tile Manual - Rev 1.00 42/63... - Page 43 Calling the most recent GPS message: $GN @*69 $GN 37.8921,-122.0155,77,89,2*0c Returns a location of 3 7.8921N, 122.0155W . The Tile's altitude is 7 7m , its course is 8 9 degrees , and it is moving at 2 kilometers per hour .
-
Page 44: Gp - Gpio1 Control
Display current GPIO1 mode mode Set GPIO1 pin mode Returns one of: Value Description $GP <mode>*xx The current $ GP mode $GP OK*xx Parameters updated successfully $GP ERR*xx Command input error June 2020 Swarm Tile Manual - Rev 1.00 44/63... - Page 45 (1) - These two variations allow the user application to use GPIO1 as a general purpose output. (2) - If either of these modes are selected, the pin will indicate if the Tile has received one or more unread messages and is holding them for the client. If multiple messages are pending for the client, the pin will maintain the state until all messages have been read.
- Page 46 Example: Setting the GPIO1 pin to input and wake on a high-to-low transition: $GP 2*05 $GP OK*33 June 2020 Swarm Tile Manual - Rev 1.00 46/63...
-
Page 47: Gs - Gps Fix Quality
$ GS ? query. <rate> is a value between 1 and 2147483647 (2 31 -1). It will be the number of seconds in between each message. June 2020 Swarm Tile Manual - Rev 1.00 47/63... - Page 48 Example: Setting the rate for geospatial information messages to 1 per second: $GS 1*05 $GS OK*30 June 2020 Swarm Tile Manual - Rev 1.00 48/63...
-
Page 49: Mm - Manage Received Messages
Manage received messages in the database. This command has the ability to return a count, list, mark and delete messages. The N option allows setting whether messages received from the Swarm network cause notifications upon reception, When N is set to D , message notifications will not be generated. In either state, messages are always retained in the database until deleted by the user. - Page 50 (2) < data> is in the same format as an unsolicited $ RD message. < msg_id> is the message ID. The message ID should be treated as a simple arbitrary number. < es> is the epoch seconds time when the message was received by the Tile. June 2020 Swarm Tile Manual - Rev 1.00...
- Page 51 Returns a hexadecimal message of 5 37761726d2052756c657321 (translated to ascii: S warm Rules! ) , a message ID of 2 1990237405212 , and the message was received at 1590620322 epoch seconds ( M ay 27, 2020 10:58:42 PM GMT ) . June 2020 Swarm Tile Manual - Rev 1.00 51/63...
-
Page 52: Po - Power Down
Command input error Notes: An O K response confirms that the Tile will shut down. The user should disconnect power from the Tile at this point. If left connected, the Tile will draw approximately 6mA on its 3.3V input Example: $PO*1F ... -
Page 53: Pw - Power Status
If no comma is present and the value is a number, then the value is the rate being returned in response to the $ P W ? query. June 2020 Swarm Tile Manual - Rev 1.00 53/63... - Page 54 <rate> is a value between 1 and 2147483647 (2 31 -1). It will be the number of seconds in between each message. Example: Setting the rate for geospatial information messages to one every 5 seconds: $PW 5*12 $PW OK*23 June 2020 Swarm Tile Manual - Rev 1.00 54/63...
-
Page 55: Rs - Restart Tile
$RS OK*xx Command has been accepted and the Tile will immediately perform a hardware restart $RS ERR*xx Command input error Notes: An O K response confirms that the Tile will successfully restart. Example: $RS*01 $RS OK*25 $TILE BOOT,RESTART*59 ... -
Page 56: Rt - Receive Test
$ R T ? query. <rate> is a value between 1 and 2147483647 (2 31 -1). It will be the number of seconds in between each message. June 2020 Swarm Tile Manual - Rev 1.00 56/63... - Page 57 Example: Setting the rate for geospatial information messages to 1 per second: $RT 1*05 $RT OK*30 June 2020 Swarm Tile Manual - Rev 1.00 57/63...
-
Page 58: Sleep Mode
The U parameter is a time and optional date the Tile should sleep until and then wake. If the date is not specified and the time to sleep until is less than the current time, the time is presumed to be in the next day. - Page 59 TIME The S or U parameter time has been reached If UART activity wakes the Tile, the T IMEOUT message will not be emitted as the Tile is now awake. In sleep mode, the real-time clock is not GPS disciplined, and is therefore subject to some degree of drift.
-
Page 60: Td - Transmit Data
$TD - Transmit data This command transmits data to the Swarm network. $TD [HD=<hold_dur>|ET=<expire_time>,]<[string|data]>*xx Parameter Description HD=<hold_dur> Hold duration of message in seconds (optional, default = 172800 seconds) ET=<expire_time> Time to expire message in epoch seconds <string|data> 1 to 200 bytes of data (ASCII string) - Page 61 $TD ERR,ERR,0*xx Unspecified error $TD ERR,EXPIRED,<msg_id>*xx Unable to send within requested hold time $TD ERR,NODEVICEID,0*xx The Swarm device ID has not yet been set $TD ERR,NOCOMMAND,0*xx $TD with no parameters was sent $TD ERR,NOSPACE,0*xx No space for message $TD ERR,NOTCID,0*xx...
- Page 62 B ADDATA message to be returned. <msg_id> is assigned by the Tile, and is an unsigned 64-bit value comprised of the device ID, a day of year counter, and a message of day counter. Responses that have a 0 as the message ID indicates the message has not been placed in the queue and therefore has no ID.
- Page 63 $TD "Hello World!"*31 $TD OK,5354468575916*2c $TD SENT,5354468575916*24 Sending a message from the Tile in ASCII that will expire in 1 hour: $TD HD=3600,"Hello World!"*29 $TD OK,5354468575917*2d $TD SENT,5354468575917*25 Sending a message from the Tile in ASCII that will expire on 2021-01-01 12:34:56: $TD ET=1609504496,"Hello World!"*1F...
Need help?
Do you have a question about the Tile and is the answer not in the manual?
Questions and answers