> For the complete documentation index, see [llms.txt](https://docs.spectralink.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spectralink.net/amie-essentials/release-notes/sam-1-6-0.md). # SAM 1.6.0 SAM Version: 1.6.0.xxx.832 For use with Versity versions: * Versity 92 Series R1.4 using Android 10 * Versity 95/96 Series R2.3 using Android 10 {% hint style="info" %} **upgrading anomaly** When upgrading to 1.6 and if using FQDN and also updating phones to R2.1 or above, you must generate a new CSR/cert and then push it to the phones in order for the phones to connect to SAM. {% endhint %} {% hint style="info" %} **SAM compatibility** SAM 1.6 was tested with Versity 92 Series 1.4 and Versity 95/96 Series 2.3. However, this version of SAM should work with any Versity smartphone software version. Any options that appear in SAM and are not in the phone menus will be ignored by the phone. Any options that are in the phone but not in SAM will be ignored by SAM unless programmed through Custom Attributes. {% endhint %} {% hint style="info" %} **What does the “xxx” stand for?** You will notice an “xxx” in the version number above. It signifies the build version of the VM the SAM software is installed on. When the SAM version is loaded at your site, the number will reflect the VM version in use at your site. SAM build versions change but VM versions do not change upon SAM software upgrade. {% endhint %} {% hint style="info" %} **Updating SAM to the current release** You will see two files for this and future releases. The upgrade version is an incremental release used to update code to the next released version. It is a smaller file with a faster download time and recommended for incremental updates. Always use the appropriate incremental file for your current release. i.e. Do not skip versions. Use the next released version. The New install file contains the full code for a new SAM VM and software deployment. {% endhint %} {% hint style="warning" %} **The full release version will install a new instance of SAM on the VM** The New install version will install a new instance of SAM with an empty database. If SAM is already deployed in your facility, do not try to “upgrade” with the New install version. Use the upgrade version unless you intend to start over. {% endhint %} {% hint style="warning" %} **Your account number is critical to SAM setup** Due to repeated situations where the SAM server was installed with a phony customer account number, a caution note is added here to help all installers understand that the correct customer account number will prevent future configuration and installation problems. Spectralink assigns a unique account number to each customer which is linked to your SAM license. If a different number is used to configure the SAM server and it is not the assigned number, the SAM license will fail and the entire server must be reinstalled. {% endhint %} ## Enhancement The SAM heartbeat is now faster which allows for better performance of SAM at scale. ## New App Features SAM supports a number of new options that have been added to Versity 95/96 R2.3 and Versity 92 R1.4. For complete information consult the Release Notes for those products and the *Versity Apps Administration Guide*. ### AMIE Agent AMIE Agent now provides an option to allow metered Wi-Fi networks. The metered Wi-Fi setting (available in SAM) allows the admin to select whether or not to allow the phone to upload software updates using Wi-Fi over the facility’s VPN network. ### Buttons Run application A programmable button can be configured to open any app or specified screen (activity) in any app that is installed on the phone. AP-7746 The ability to program extras has been added so that pressing the button will perform a specified function within that activity. Extras can be strings, Booleans and integers. The Run Application feature will support as many extras as are required. Use the following format: com.example.app/com.example.app.activity/string:param1=exampleString,boolean:param2=true,integer:param3=42 ### Device Battery percentage Now the battery percentage remaining will appear in the status bar and can be user controlled or admin controlled to appear or not. When enabled either by the user or by the administrator, the battery’s current percentage is displayed in the status bar. Auto-rotate screen Now the user or admin can control if the screen auto-rotates from portrait to landscape in response to the screen being rotated. If Auto-rotate screen setting is set to User controlled, the Android settings will be available to the user to change the setting. If the setting is NOT User controlled, the corresponding Android settings will be grayed out and EMM/SAM settings will be used. The screenshots here show the Android settings menu with user control enable. Allow Wi-Fi validation Previous to R2.3.0, Versity smartphones used a “captive portal” to validate Wi-Fi connectivity which required an external internet connection. The “Allow Wi-Fi validation”, offers the option to use the captive portal method or to disable captive portal and allow the smartphone to validate the Wi-Fi connection internally. The default behavior disables the captive portal method and the smartphone validates Wi-Fi through pinging internal servers. ESC-1570 ### Logging Advanced logging Network configuration options for metered networks have been added. The default settings are the settings used in prior releases. The new settings are the added options as noted below. ESC-1569 * Use only unmetered Wi-Fi connections (default) * Use all Wi-Fi connections, just not LTE connections * Use all connections regardless of metered/unmetered When configured with SAM/EMM, user settings are available. * User cannot edit network configuration settings (default) * User can edit the network configuration settings Network capture Adds the ability to capture Layer 1 packets. There is no separate setting. Layer 1 information is now included in log results. ESC-1594 Increase snaplen to 262.144 for larger Layer 1 packets. AP-5189 In order to preserve battery life and prevent the SIM card from filling up with log data, network capture will not function while VPN is enabled. ### Sys Updater Wi-Fi network configuration Options to support metered and unmetered connections. AP-7843 Delayed update A new feature for situations where an update should be downloaded but not applied until a later time. Also called “silent download”. When activated the update is downloaded onto the phone but is not applied. The current version is used until the admin triggers the update at which time the user will be prompted to reboot the phone at which time the update will be applied. ### VQO Channels Channel 14 for 2.4 GHz has been deprecated. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.spectralink.net/amie-essentials/release-notes/sam-1-6-0.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.