AT+WDM - undocumented?

Developer Studio, Discovery Tool, Watcher

AT+WDM - undocumented?

Postby awneil » Thu Dec 23, 2010 2:38 pm

DevStudio 1.2.0 connected to Fastrack XTend with 7.4.0.a firmware.

Target Status & Configuration gives 1 warning:

Local port: Impossible to detect local port (no answer to AT+WDM=2)


What is AT+WDM :?:

It is not mentioned in the AT Commands Interface Guide for Firmware 7.44 (nor any earlier version)

I presume it must be to do with the new "Development mode" - for which I'd have to update the XTend firmware ?

Note that "no answer" is not correct: the XTend does answer - with "ERROR"
When I say "SiWi", that's short for "Sierra Wireless".
User avatar
awneil
 
Posts: 6603
Joined: Mon Dec 03, 2007 1:18 pm
Location: Basingstoke, UK
Has thanked: 54 times
Have thanks: 85 times

Re: AT+WDM - undocumented?

Postby sjudith » Wed Dec 29, 2010 10:32 am

You're right.
This command allows a user to lock a port into the development mode.
This mode is used by Developer Studio to get traces from the device for debug. It is persistent to the resets.
sjudith
 
Posts: 10
Joined: Wed Dec 16, 2009 10:01 pm
Location: France
Has thanked: 0 time
Have thanks: 0 time

Re: AT+WDM - undocumented?

Postby awneil » Wed Mar 09, 2011 2:19 pm

sjudith wrote:It is persistent to the resets.

Therefore it needs to be documented - so that a user can find how to get a module out of Development mode when it's "accidentally" been left in development mode!

See: viewtopic.php?f=108&t=5156&p=22613#p22613
When I say "SiWi", that's short for "Sierra Wireless".
User avatar
awneil
 
Posts: 6603
Joined: Mon Dec 03, 2007 1:18 pm
Location: Basingstoke, UK
Has thanked: 54 times
Have thanks: 85 times

Re: AT+WDM - undocumented?

Postby daav » Thu Mar 10, 2011 9:17 am

A quick preview of what will be documented in a future Firmware release:


Code: Select all
AT+WDM=0

Resets the development mode persistence (the persisted port will return to production mode after a target reset)


Code: Select all
AT+WDM=1

Asks for development mode to be persisted on the current port (the current port will stay in development mode even after a target reset)


Code: Select all
AT+WDM=2

Just a query command to retrieve the current port ID


Code: Select all
AT+WDM?

A query command to retrieve the development mode persistence state (0/1), and the port ID on which the persistence has been configured.
Developer Studio dev team
User avatar
daav
 
Posts: 1198
Joined: Thu Oct 20, 2005 11:45 am
Location: Paris, France
Has thanked: 8 times
Have thanks: 87 times

Re: AT+WDM - undocumented?

Postby awneil » Thu Mar 10, 2011 9:25 am

Thanks!

:D
When I say "SiWi", that's short for "Sierra Wireless".
User avatar
awneil
 
Posts: 6603
Joined: Mon Dec 03, 2007 1:18 pm
Location: Basingstoke, UK
Has thanked: 54 times
Have thanks: 85 times

Re: AT+WDM - undocumented?

Postby awneil » Fri Jun 03, 2011 1:59 pm

Just to clarify a few points:

daav wrote:
Code: Select all
AT+WDM=0

Resets the development mode persistence (the persisted port will return to production mode after a target reset)

Can be issued on any port - doesn't have to be the port currently in Development mode

Code: Select all
AT+WDM=2

Just a query command to retrieve the current port ID

ie, the port on which the command was issued - not (necessarily) the port that's in Development mode.

The port ID has the same values as used by AT+WMFM; viz,
1 = UART1;
2 = UART2;
3 = USB.

Code: Select all
AT+WDM?

A query command to retrieve the development mode persistence state (0/1), and the port ID on which the persistence has been configured.

The response is:
Code: Select all
AT+WDM: <port-id>,<state>
When I say "SiWi", that's short for "Sierra Wireless".
User avatar
awneil
 
Posts: 6603
Joined: Mon Dec 03, 2007 1:18 pm
Location: Basingstoke, UK
Has thanked: 54 times
Have thanks: 85 times

Re: AT+WDM - undocumented?

Postby daav » Mon Jun 06, 2011 6:39 am

awneil wrote:
daav wrote:
Code: Select all
AT+WDM=0

Resets the development mode persistence (the persisted port will return to production mode after a target reset)

Can be issued on any port - doesn't have to be the port currently in Development mode

Correct.
Code: Select all
AT+WDM=2

Just a query command to retrieve the current port ID

ie, the port on which the command was issued - not (necessarily) the port that's in Development mode.
The port ID has the same values as used by AT+WMFM; viz,
1 = UART1;
2 = UART2;
3 = USB.

Correct.
Code: Select all
AT+WDM?

A query command to retrieve the development mode persistence state (0/1), and the port ID on which the persistence has been configured.

The response is:
Code: Select all
AT+WDM: <port-id>,<state>

Actually, I just made the check, and the response is +WDM: <state>,<port-id>, but the behavior is quite strange... <state> is always 1, and <port-id> is really the "persisted dev mode" port ID, but in addition it will be set to 0 if no port is configured in this mode (default state).
I'm dealing with the FW team to see if they plan to change this behavior.
Developer Studio dev team
User avatar
daav
 
Posts: 1198
Joined: Thu Oct 20, 2005 11:45 am
Location: Paris, France
Has thanked: 8 times
Have thanks: 87 times

Re: AT+WDM - undocumented?

Postby awneil » Mon Jun 06, 2011 7:11 am

Thanks for the clarifications!

:D

daav wrote:I'm dealing with the FW team to see if they plan to change this behavior.

Since there are already units in the field with this behaviour, I think it would probably be too confusing to change it now.

IMO, best to leave it as-is, but ensure that it is clearly documented.
When I say "SiWi", that's short for "Sierra Wireless".
User avatar
awneil
 
Posts: 6603
Joined: Mon Dec 03, 2007 1:18 pm
Location: Basingstoke, UK
Has thanked: 54 times
Have thanks: 85 times

Re: AT+WDM - undocumented?

Postby daav » Tue Jun 07, 2011 6:59 am

awneil wrote:Since there are already units in the field with this behaviour, I think it would probably be too confusing to change it now.
IMO, best to leave it as-is, but ensure that it is clearly documented.

That's also our opinion: too late to change it now :wink:
Developer Studio dev team
User avatar
daav
 
Posts: 1198
Joined: Thu Oct 20, 2005 11:45 am
Location: Paris, France
Has thanked: 8 times
Have thanks: 87 times

Re: AT+WDM - undocumented?

Postby awneil » Wed Jan 16, 2013 10:10 am

It is now documented in the 7.46 AT Commands Guide

:D
When I say "SiWi", that's short for "Sierra Wireless".
User avatar
awneil
 
Posts: 6603
Joined: Mon Dec 03, 2007 1:18 pm
Location: Basingstoke, UK
Has thanked: 54 times
Have thanks: 85 times


Topic Tags

R7.46, WDM

Return to Development tools

Who is online

Users browsing this forum: No registered users and 2 guests