Follow Up: Automating the Setup Process for Motorola Devices

Some time ago, I asked if anyone knew of a way to automate the setup process for Motorola devices. Judging by the absolute silence, either no-one has succeeded in this task or it's a well kept secret within the industry!

Well, I think I've cracked it!

One pre-requisite is these fantastic command line CE tools, you can download from; https://sites.google.com/a/essemer.com.au/www/windowsce ( http://www.essemer.com.au/ )

The other, is the "rapistart.exe" executable from Microsoft's Windows Mobile PowerToys ( http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=10601 )

Step 1:

You'll need a mobile application to set the wireless profile settings & export them to a reg file. We'll export these settings to the "\Application" folder so they survive a cold boot.

Module MotorolaSetWLANApp
Private _IPAddress As String
Private _SubnetMask As String
Private _SSID As String
Private _Passphrase As String

Private _SetIPSettings As Boolean = False

Public Sub Main(ByVal args As String())
If args.Length > 0 Then
For i As Integer = 0 To args.Length - 1
Select Case args(i).ToLower
Case "-ip"
'get IP settings
_IPAddress = args(i + 1)
_SetIPSettings = True
Case "-subnet"
_SubnetMask = args(i + 1)
Case "-ssid"
_SSID = args(i + 1)
Case "-passphrase"
_Passphrase = args(i + 1)
End Select
Next
End If

If _SetIPSettings Then
Using Settings As New Symbol.Fusion.WLAN.WLAN
Dim ProfileData As New Symbol.Fusion.WLAN.InfrastructureProfileData(_SSID, _SSID)
With ProfileData
.PowerMode = Symbol.Fusion.WLAN.PowerMode.FAST_POWER_SAVE
.TransmissionPower = Symbol.Fusion.WLAN.InfrastructureProfileData.TransmitPowerLevel.BSS_AUTO
.IPSettings.AddressingMode = Symbol.Fusion.WLAN.IPSettings.AddressingModes.STATIC
.IPSettings.IPAddress = _IPAddress
.IPSettings.SubnetMask = _SubnetMask
.SecurityType = Symbol.Fusion.WLAN.WLANSecurityType.SECURITY_WPA_PERSONAL
.Authentication.AuthenticationType = Symbol.Fusion.WLAN.Authentication.AuthenticationTypes.NONE
.Encryption.EncryptionType = Symbol.Fusion.WLAN.Encryption.EncryptionTypes.TKIP_PASSPH
.Encryption.PassPhrase = _Passphrase
End With
Settings.Profiles.DeleteAll()
Settings.Profiles.CreateInfrastructureProfile(ProfileData)
Settings.Profiles.ExportAll(Symbol.Fusion.FileFormat.REG_FILE, Symbol.Fusion.WLAN.Profiles.ExportImportOpMode.MULTIPLE_PROFILE, "\Application\", Guid.NewGuid.ToString & ".reg")
End Using
End If

'force close (possibly superfluous)
Application.Exit()
End Sub
End Module


Pay attention to the WLAN settings - this example relates to our infrastructure but yours may differ. Luckily, for English-speakers, the settings in the Fusion API closely resemble the options in the "Manage Profiles" option on the Motorola Fusion tray icon that is installed by default on most devices so it's quite easy to work out what your settings should be if you have successfully configured the device using the Motorola UI.

From here, it's pretty straightforward. You simply need to run the application on the device with the correct settings passed in. This is where those CE tools come in. I copied all these tools to a folder names "tools" in our deployment application. From here, I can copy the executable I just made to the device and execute it with the arguments I need to.


Private Sub RunWait(ByVal App As String, ByVal Args As String)
Dim AppProcess As System.Diagnostics.Process
AppProcess = New System.Diagnostics.Process()
AppProcess.StartInfo.FileName = App
AppProcess.StartInfo.WindowStyle = ProcessWindowStyle.Normal
AppProcess.StartInfo.Arguments = Args
If AppProcess.Start() Then
'Wait until the process passes back an exit code
AppProcess.WaitForExit()
End If
'Free resources associated with this process
AppProcess.Close()
End Sub

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
'copy application to device
RunWait(ToolsDir & "cecopy.exe", "/IS " & ToolsDir & "MotorolaSetWLan.exe dev:\application")
'execute app on device
RunWait(ToolsDir & "rapistart.exe", "\application\MotorolaSetWLan.exe -ip 123.123.123.123 -subnet 255.255.252.0 -ssid WLAN -passphrase password")

End Sub


I'm sure you can elaborate some pretty cool solutions from this, I'm planning a one-click deployment process for our IT Support desk to deploy quickly. Although our applications update over-the-air, Motorola hotfixes and EMDK updates currently require a lot of work to organise the upgrade - this tool will simplify the process. We also recycle devices for different purposes across the business - again, this tool will help us quickly reconfigure our devices for use in other areas of the business quickly.