Recent pages![]() |
SensorGnome - fresh data from the field to your plate > Software for Deploying a Sensorgnome > Release History
Release History Release HistoryEdit From $1Table of contents
Notes:
2017 May 24: update to support detection of Cornell tagsThis update is for users who want their (beaglebone-based) SG to detect tags made by Gabrielson & Winkler Update is here and installation instructions are here.
RECOMMENDED:
|
file \\192.168.7.2\boot\WIREDNET.TXT exists | SG might interfere with local computers | you can connect a laptop to SG via ethernet |
---|---|---|
yes | no | no |
no | yes | yes |
The update is available here:
2016-08-25_sensorgnome_update.tar.bz2
and installation instructions are here.
(incremental update to 2016 June 17 update)
After installing this update and rebooting, FTP access can be obtained with user "root" (password "root")
which will let you download log files via FTP.
You can update a beaglebone from the 2016-06-17 version using this update file:
(this update replaces the 2016 June 9 update, and can be installed on top of it)
Some users are unable to connect to the SG using a USB cable, because drivers to do so
are buggy or cannot be installed on a government-issued computer. For the same reasons,
some users are unable to download the SG's data files using the network drive. This update enables
connection using an ethernet cable, and access via FTP. After installing it, you can use any FTP client
on your computer to access the SG's data files. Most web browsers can do this. You should use
an FTP client that can download entire folders at a time. We recommend the FireFTP extension to
the Firefox browser, which can be installed using Firefox's "Add-ons" menu.
You can update a beaglebone from the 2016-02-02 or later version using this update file:
2016-06-17_sensorgnome_update.tar.bz2
or you can (re-)image your beaglebone to this version using an image file:
sensorgnome_image_2016-06-17_12-56-03.img.7z
You can also operate a broken beaglebone with this rescue image:
sensorgnome_rescue_image_2016-06-17_12-56-03.img.7z
which works like a regular image, except it doesn't try to re-image
your beaglebone. You need one rescue image SD card per broken
system, since the card has to be installed for the SG to work.
Installation instructions for the images and for the update.
Notes:
Here's how to connect to your SG after you have installed this update and rebooted it:
Physical Connection to SG uses: | ||
---|---|---|
Service: | USB cable Drivers required on your computer. | Ethernet cable No drivers needed! Your computer's wired network adapter must be set to automatically obtain its IP address, which it probably is... |
SG Interface (use a web browser) | http://192.168.7.2 | http://192.168.9.2 |
SG Storage (open as network drive) | \\192.168.7.2\data | \\192.168.9.2\data |
SG Storage (use a web browser, or an FTP client such as Firefox FireFTP Add-on) | ftp://bone:bone@192.168.7.2 (browser) or host: 192.168.7.2 (FTP client in passive mode) user: bone password: bone | ftp://bone:bone@192.168.9.2 (browser) or host: 192.168.9.2 (FTP client in passive mode) user: bone password: bone |
There are three folders visible at the toplevel of the SG storage:
A good FTP client such as FireFTP will let you download entire folders at once, delete folders on the SG, and upload
files to the system_boot folder.
Some users are unable to connect to the SG using a USB cable, because drivers to do so
are buggy or cannot be installed on a government-issued computer. This update and image
permit users to connect to an SG in two ways:
SG Interface (use web browser) | Data Disk (open as network drive) | Boot Disk (open as network drive) | |
Connection by: | |||
USB cable
Drivers required
on your computer.
| http://192.168.7.2 | \\192.168.7.2\data | \\192.168.7.2\boot |
Ethernet cable
No drivers needed!
Your computer's wired
network adapter must be
set to automatically
obtain its IP address,
which it probably is...
| http://192.168.9.2 | \\192.168.9.2\data | \\192.168.9.2\boot |
Note:
Image file:
sensorgnome_image_2016-05-20_15-59-45.img.7z
This image file includes the updates of 4 May, 21 April, and 28 April.
You can instead update from the 2016-02-02 image using this update file:
2016-05-20_sensorgnome_update.tar.bz2
Installation instructions for the image and for the update.
Details:
With this image installed, you can connect a laptop to the SG's web interface and data driver using
a network ("ethernet") cable. This does not require installing beaglebone drivers on the laptop. The
laptop wired network adapter must be set to automatically obtain its IP address. Also, this should
work even if you hot-plug the ethernet cable (i.e. plug into an already-running SG); you might need
to wait a minute for the ethernet connection to come up. Ethernet cable connectors are not as robust
as USB cable connectors, unfortunately.
If the other end of the ethernet cable is already plugged into a wall jack or router when the SG boots,
then it will still try to connect to our server for remote troubleshooting.
Update file: 2016-05-04_sensorgnome_update.tar.bz2
Installation instructions
The fcd_watchdog runs every 2 minutes to make sure all attached funcubes are operating, and restarts
any which are not. fcd_watchdog is a one-line script, but uses a program called nc to connect to the
funcube data capture program. Unfortunately, some SGs seem to have the "busybox" version of nc installed
in /usr/bin, which is trumping the correct version installed in /bin as part of the sensorgnome software.
I don't understand how this has happened, as the SG software installation is supposed to delete all
pre-installed software. In any case, if your SG has the 2016-02-02 software release, and is still showing
antennas stalling, then try this update.
Update file: 2016-04-28_sensorgnome_update.tar.bz2
Installation instructions
This update displays the "bandgap temperature" on the SG web interface. The value is re-sampled each time
the web interface page is manually refreshed. This is an estimate of the temperature in
the SG's main processing chip. The beaglebone is only rated to operate at bandgap temperatures up to 90° C.
Higher temperatures will likely cause system failure.
This update includes the 21 April update, so it also displays the LAN MAC address on the SG web interface.
Update file: 2016-04-22_sensorgnome_update_for_Huawei_e398_deutsche_telekom_turbostick.tar.bz2
Apply this update to an SG running the 2016-02-02 image to use this device.
Update file: 2016-04-21_sensorgnome_update.tar.bz2
Installation instructions
This update displays the Beaglebone ethernet adapter's MAC address on the SG web interface,
for those few users who might need to supply this information to their internet providers.
Update file: 2016-04-13_sensorgnome_update_for_Huawei_e8372_bell_canada_turbostick.tar.bz2
Apply this update to an SG running the 2016-02-02 image to use this device.
Update file: 2016-02-02_sensorgnome_update.tar.bz2
This updates a unit from the 2015-08-27 version to the 2016-02-02 version.
If your SG has a software version older than 2015-08-27, you should instead re-image it
with the following file:
Image: sensorgnome_image_2016-02-02_13-00-09.img.7z
Installation instructions for the image and for the update.
Changes:
Update file: 2015-10-16_sensorgnome_optional_update.tar.bz2
Installation instructions
This allows you to connect to your SG via a network cable. However, you will need to know the IP address the SG has
been assigned, either by the router or by your own computer. This is only intended for local area networks,
and should not be applied to an SG which will be connected directly to the internet, as it is not secure: anyone anywhere
could modify files on your SG. This is identical in purpose to the 2015 Mar 16 update, but modified to apply
to the 2015 Aug 27 image.
Update file: 2015-08-27_sensorgnome_update.tar.bz2
Image: sensorgnome_image_2015-08-27_13-18-25.img.7z
Installation instructions for the image and for the update.
This update replaces the broken 28 July update, and should fix several reliability issues.
While it has not undergone as much testing as we'd like, it has run without issues on 5
SGs (both beaglebone blacks and whites) with a total of 14 funcubes for 17 days,
with some stress testing. It will be the version used to update the Motus Ontario and Atlantic
arrays over the coming weeks. Any bugs discovered will be reported to the sensorgnomads
mailing list and fixed as soon as possible. The update file should work on any late-2014 version of
the SG software, bringing it fully up to date, but those running versions from 23 May 2014
or earlier should re-image their SG, rather than using the update.
Unlike previous images, if this one is used to re-image an SG, it will preserve existing
deployment.txt, network.txt, and SG_tag_database.csv/.sqlite files.
(The update file also preserves these user files, as usual.)
This update will reprogram all attached funcubedongles to the 48 kHz sampling firmware.
Some users have experienced outages with one or more of these symptoms:
While it seems most occurrences of these problems are on units with unreliable or
insufficient power, they have also been observed on AC-connected systems.
It has been difficult to track down the source of the problems, because they
are very infrequent. This update works around our ignorance and sets up two
watchdogs which look for symptoms and attempt corrective actions:
This is not a very satisfying update, in that we still don't understand the underlying problems,
but we expect it will prevent some long periods of outage (these are rare, but significant).
After installing this update, you can still prevent either watchdog from operating by deleting
the appropriate file. Connect to the network root drive of a USB-connected SG:
\\192.168.7.2\root (Windows) or smb://192.168.7.2/root (OS X, linux)
then navigate to the folder etc/cron.d and delete the appropriate watchdog file(s):
bin boot dev etc ----> ... ... cron.d ----> ... ... fcd_watchdog ## delete to prevent automatic restart of funcubes usb_watchdog ## delete to prevent automatic reboots of SG when no USB devices are found ...
Most users should leave the watchdogs active.
Update file: 2015-07-20_sensorgnome_update.tar.bz2
Installation instructions here. After uploading the update file to the SG, power down the SG, attach all
funcubes you wish to use with it, then power back up. When you then visit the web interface,
all funcubes should be operating at a hardware frame rate of 48 kHz, as shown in the
What I'm doing now table. Booting will take approximately 25 seconds longer for each
funcubedongle that needs to be reprogrammed, but this happens only once per FCD.
This update should work on any version of the 2014 software release.
After installation, whenever the SG boots, any attached Funcubedongle
Pro Plus will have its firmware updated to do sampling at 48 kHz
(rather than the default 192 kHz). This permits up to 6 Funcubedongle
Pro Plus dongles to be used on a single SG. The firmware update
persists across reboots, even if the funcubedongle is subsequently plugged into a
different SG.
these lines:
{ "info": "default deployment", "who": "who is responsible for this deployment",
become these lines:
{
"info": "default deployment",
"option": "NO_AUTO_FCD_UPDATE",
"who": "who is responsible for this deployment",
i.e. insert the line "option": "NO_AUTO_FCD_UPDATE", after the "info" line, making sure to include the trailing comma.
Update file: 2015-05-01_sensorgnome_update.tar.bz2
Image: sensorgnome_image_2014-12-11_11-57-00-rev2.img.7z
Installation instructions for the image and for the update.
This is now the recommended image of the 2014 software release. A serious bug in frequency switching
is fixed. The tag database can now contain tags from the same project with the same ID but different burst interval,
and these are displayed correctly in the web interface. Users can install either the .sqlite or the .csv version
of the tag database.
Update file: 2015-04-23_sensorgnome_update.tar.bz2
Installation instructions
For users deploying more than one tag with the same ID a software update is required in order to distinguish
between those tags in the web interface. This just allows you to distinguish between tag detections in the field.
If you only care about distinguishing between those tags when sensorgnome.org processes the raw data from
your receiver, then you do not need to apply this update. The upcoming 2015 software release will include
this fix.
Note: Users applying this fix will also need to install the ".sqlite" version of their tag database on the receiver,
rather than the ".csv" version.
Recent Beaglebone Black computers have a slightly different flash memory chip capacity, which confused
the SG software. This bug has now been fixed in a way that should prevent it happening again with any
subsequent changes to the flash memory. If you imaged a new beaglebone, and found that it would
not work correctly with a micro SD data card installed, you will need to do two things:
(The bug caused the SG to reformat and copy its software to the data card, in a way that prevented
its use for storing data. With this bug, if you image the beaglebone and then reboot with a blank
micro SD card, you will not be able to connect to the web interface.)
Thanks to Michelle Stantial for help in diagnosing and correcting this problem.
Image: sensorgnome_image_2014-12-11_11-57-00-rev1.img.7z
The 2015 Mar 16 update can still be applied to the revised 2014-12-11 image.
Barring other show-stopping bugs, this is the final release of the 2014 SG software.
Update file: 2015-03-16_sensorgnome_update.tar.bz2
Note: above link corrected on 2015 03 28.
Installation instructions
This allows you to connect to your SG via a network cable. However, you will need to know the IP address the SG has
been assigned, either by the router or by your own computer. This is only intended for local area networks,
and should not be applied to an SG which will be connected to the internet, as it is not secure: anyone anywhere
could modify files on your SG.
Image: sensorgnome_image_2014-12-11_11-57-00-rev1.img.7z
Update file: 2014-12-11_sensorgnome_update.tar.bz2
Installation instructions
Note: the update requires 2 reboots (rather than the usual 1) before it takes effect.
Replaces the 2014-09-03, 2014-08-27, and 2014-09-10 updates, which were broken.
The most recent fix corrects the hang-on-boot problem with the 2014-09-10 update when
a GPS cape was not installed.
This is for the initial model of the cape, which does not have an embedded serial number
and so is not (yet) an official beaglebone cape. It also supports the Adafruit GPS breakout
board, as described here. Users of the standard USB GPS or of the older, non-cape PPS GPS
do not need this update, but it should not cause any problems. This update includes the changes
from the 2013 Aug 13 update, and slightly reformats the device list to better distinguish
between devices attached directly to the beaglebone and those connected via a USB hub.
The update must be applied to the 23 May image.
Update file: 2014-08-13_sensorgnome_update.tar.bz2
Installation instructions
Problems fixed:
If you tried to run a stripped-down sensorgnome without a USB hub, and with a funcubedongle attached directly
to the beaglebone computer's USB port, the live tag window would not show any detections and the device
list does not show the funcube.
Note: if you are deploying to a remote site with little chance of revisiting during the field season,
and your SG computer is not the Beaglebone Black Revision C (which requires the May 23 or later
version), please use the March 03 version instead - it has seen longer field testing.
Image: sensorgnome_image_2014-05-23_17-23-36.img.7z
Installation instructions
Changes:
Update file: 2014-05-15_sensorgnome_update.tar.bz2
Installation instructions
Uses a more numerically stable pulse detection algorithm, which may result in smaller file sizes
at noisy sites.
Update file: 2014-05-13_sensorgnome_update.tar.bz2
Installation instructions
Problems fixed:
If a periodic schedule was created in deployment.txt to e.g. switch VHF telemetry frequencies, the periods were not applied to the corresponding parameter values, but rather the next one. For example:
"schedule": { "type": "periodic", "states": [ 150, 166 ], "periods": [ 30, 10] }
would incorrectly schedule listening as 10 seconds @ 150 MHz alternating with 30 seconds @ 166 MHz. [incorrect behaviour]
The update corrects the behaviour to: 30 seconds @ 150 MHz alternating with 10 seconds @ 166 MHz, as clearly intended.
Update file: 2014-05-12_sensorgnome_update.tar.bz2
Installation instructions
Image file: sensorgnome_image_2014-05-09_17-10-18.img.7z
Installation instructions
Problems fixed:
For those few users who installed the 2014 April 29 image:
Update file: 2014-05-09_sensorgnome_update.tar.bz2
Update file: 2014-04-25_sensorgnome_update.tar.bz2
Installation instructions
Problems fixed:
(if you don't know what this is, you don't need it)
Update file: 2014-04-17_sensorgnome_update.tar.bz2
Installation instructions
Problems fixed:
The fix increases the priority of the chronyd process (responsible for clock syncing) above that of the data acquisition processes,
and prevents chrony from selecting the non-PPS GPS times as the primary clock source.
The update file is 2014-04-12_sensorgnome_update.tar.bz2 and update installation instructions are here.
Problems fixed:
"devParams": [ { "name": "frequency", "schedule": { "type": "Constant", "value": 166.376 } } ], "raw": { "enabled": true, "chunkMinutes": 5 },
then funcubes would not be set to listen at 166.376 MHz.
Image file: sensorgnome_image_2014-03-03_17-58-42.img.7z
This release has been tested in the field and is recommended for deployment at remote
telemetry locations where visits during the season are impractical.
NOTE: users with the latest Beaglebone Black (Revision "C", shipped from May 2014 onward) must
use the 23 May version or later, not this version.
The register_sg and maintain_ssh_tunnel scripts are now run from a crontab, rather than when a network interface comes up. The latter approach did not work reliably with wireless networks, and was less robust in dealing with broken leases on the router end.
This is the first version to support both models of beaglebone from a single image file.
The image can be written to 4, 8, 16, or 32 GB micro SD cards. Space on the card not used by the download
will be reclaimed as data sorage space the first time the card is booted in a SensorGnome.
If either a wired internet connection, or a WiFi connection via the TP-Link TL-WN725N
USB adapter is found, then live tag, GPS, and status data are uploaded to the server at sensorgnome.org
via an encrypted connection. This connection also allows us to remotely troubleshoot a sensorgnome.
Known issues are here.
While we don't recommend using this hub due to bandwidth allocation issues, some older sensorgnomes have
them. The Beaglebone White version of the software supports this hub, but the Beaglebone Black version
does not, until you apply this update.
For users whose sensorgnomes are not getting a correct date/time on the web interface even though
they are getting a GPS fix, this update will force the clock to be set. Normally, we use third party
software (gpsd and chrony) to handle updating the system clock from the GPS, but this appears to
be problematic for the non-PPS GPS.
For users requiring hard drive storage (e.g. acoustic monitoring), this update adds drivers
needed to allow writing data to a USB hard drive formatted in Windows' NTFS
file system. Just about any off-the-shelf PC USB hard drive comes pre-formatted with NTFS.
Without this update, hard drives might appear in the device list, but no data will be written to them
and their size and free space will not be shown.
For this upgrade to take effect, you need to reboot the sensorgnome 2 times after applying the update.
After the first reboot, wait until you can connect via the web interface before booting again.
("Boot" means disconnect then reconnect the power; always disconnect the USB connection
to the computer before disconnecting the power to the sensorgnome).
Note: only use a hard drive if you really need the storage - the power consumption is considerably higher than
that of a flash drive or micro SD card.
Fixes various issues, such as not setting the system clock from a non-PPS GPS.
Use this to image new BBB sensorgnomes, and re-image any non-working BBB sensorgnomes.
No updates need to be applied to this image.
This bug prevents VHF telemetry from working!! I inadvertently pushed out a broken
version of the plugin library. The attached fix file should be saved as sensorgnome_update.tar.bz2
onto the SENSORGNOME drive that pops up when you put the BBB imaging disk into your computer.
This bug prevents users from deleting the existing deployment.txt and SG_tag_database.csv files
on the shared network drive at \\192.168.7.2\boot. Even with this bug, users should still be able to
overwrite these files directly, by right-clicking on the file, opening it with WordPad (Windows) or
TextEdit (Mac), editing, then resaving. The bug can be fixed by uploading the
update file attached below via the SensorGnome's web interface, as described here.
This bug affects users doing frequency switching, using either the white or
black beaglebone. It can be fixed by uploading the update file attached below
via the SensorGnome's web interface, as described here
Details on the bug are here.
At long last, we've started putting disk images on the web for download, so that you don't have to
rely on us to burn cards for your SensorGnome. Instructions are here.
File | Size | Date | Attached by | |||
---|---|---|---|---|---|---|
![]() | 2013-Aug-14_sensorgnome_BBB_network_drive_permissions_fix.tar.bz2 fixes a bug preventing deletion of files on the network "boot" drive | 3.87 kB | 18:48, 14 Aug 2013 | john | Actions | |
![]() | 2013-Aug-16-sensorgnome-BBB-plugin_and_network_fix.tar.bz2 this fix needs to be applied directly to the BBB imaging micro SD card; save to SENSORGNOME disk and rename to sensorgnome_update.tar.bz2 | 101.03 kB | 13:04, 16 Aug 2013 | john | Actions | |
![]() | 2013-Sep-06-sensorgnome-BBB-use_GWC_HU2SA0R_10_port_hub_with_bbb.tar.bz2 Supports use of the GWC 10-port USB hub (used in some older sensorgnomes) with the BBB computer. Can be uploaded via the "update software" portion of the web interface, or saved to the BBB imaging micro SD card and then renamed to sensorgnome_update.tar.bz2 | 321 bytes | 18:05, 6 Sep 2013 | john | Actions | |
![]() | 2013_Aug_03_sensorgnome_bugfix.tar.bz2 fixes a bug in frequency switching | 2.62 kB | 02:59, 3 Aug 2013 | john | Actions | |
![]() ![]() | ![]() | 2013_Aug_29_sensorgnome_bbb_update_force_clock_setting_from_GPS.tar.bz2 this update forces the system clock to be set directly from a GPS time fix once it is available; this should only be needed for people using the non-PPS GPS | 1748 bytes | 19:04, 29 Aug 2013 | john | Actions |
![]() ![]() | ![]() | 2013_Aug_29_sensorgnome_bbb_update_NTFS_drivers.tar.bz2 this update provides drivers for the NTFS filesystem present on most PC USB hard drives | 835.18 kB | 19:05, 29 Aug 2013 | john | Actions |
![]() | bugfix_2013May08.tar.bz2 save this as sensorgnome_update.tar.bz2 then follow instructions on the software update page | 2.48 kB | 18:08, 8 May 2013 | admin | Actions | |
![]() | update_2013Apr08_to_2013Apr19_files.tar.bz2 save this file as sensorgnome_update.tar.bz2, then follow instructions on the Software Update page | 1380.85 kB | 23:44, 19 Apr 2013 | john | Actions |
Images 0 | ||
---|---|---|
No images to display in the gallery. |
Viewing Details: