Ambit Apps Compilation

[pavel.samokha]

What is it?

Service to compile Ambit Apps into binaries ready for uploading to the watch after Movescount no longer available.

ATTENTION The implementation lacks proper testing and provided AS IS without any warranties.

Formal disclaimer:

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

How to use it

• Access Compiler UI
• Sample code is loaded, press “Compile”
• Grab the response, it has the same format as used by SuuntoLink
• Add the response to ambit-apps index file in SuuntoLink
  • Mac: /Applications/Suuntolink.app/Contents/Resources/app/suunto-apps/index.json
  • Windows: C:\Users\<username>\AppData\Local\Suuntolink\app-4.x.x\resources\app\suunto-apps\index.json
• Connect the watch to your computer, configure sport mode with custom app, in the dropdown list you will see your newly added app

Detailed instructions

• User variables are passed in the code in so called HEADER section
• In the header section variable names “prefix”, “postfix” and “format” are reserved for:
  • prefix and postfix - results prefix and postfix texts
  • format - output format. Should be set to one of fixed values set. Possible values: ZeroDecimals, OneDecimal, TwoDecimals, Time
• Response contains mock fields “ruleId”,“name”,“categoryId”,“activityId”,“userCount” which are always set to the same value. Feel free to change them as you want
• Keep in mind, that “ruleId” should be unique within your SuuntoLink installation!

API

Compiler service can be called via API, sample request & response below:

curl --location --request POST 'https://ambitappscompiler.azurewebsites.net/api/compile' \
--header 'x-functions-key: qakj8vb/62VgzmSl19mDQzRmW7nCSDv0zAo2A1aC3ldfd8U8r5jksA==' \
--header 'Content-Type: text/plain' \
--data-raw '/***HEADER***/
print = 0
myCounter = 0
estimateScreen = 0
/***ENDHEADER***/
/* While in sport mode do this once per second*/
/* Make user run 1 km before any estimation is given, show the duration to estimate*/ if((SUUNTO_DISTANCE < 1) && (estimateScreen == 0)){
print = ((1-SUUNTO_DISTANCE)*1000)/(SUUNTO_AVG_SPD*1000/3600); prefix = "Run";
postfix = "h";
}
if ((SUUNTO_DISTANCE >= 1) && (estimateScreen == 0)){
estimateScreen = 1;
myCounter = 0; }
/*Now when user have ran more than 1km*/
/*Scroll through the different time estimation screens*/ if ((estimateScreen == 1) && (myCounter >= 2)){
print = SUUNTO_DURATION * Suunto.pow((5000/(SUUNTO_DISTANCE*1000)), 1.06); prefix = "5K";
myCounter = 0;
estimateScreen = 2;
}
if ((estimateScreen == 2) && (myCounter >=2)){
print = SUUNTO_DURATION * Suunto.pow((10000/(SUUNTO_DISTANCE*1000)), 1.06); prefix = "10K";
myCounter = 0;
estimateScreen = 3;
}
if ((estimateScreen == 3) && (myCounter >=2)){
print = SUUNTO_DURATION * Suunto.pow((21097/(SUUNTO_DISTANCE*1000)), 1.06); prefix = "1/2 M";
myCounter = 0;
estimateScreen = 4;
}
if ((estimateScreen == 4) && (myCounter >=2)){
print = SUUNTO_DURATION * Suunto.pow((42195/(SUUNTO_DISTANCE*1000)), 1.06); prefix = "Mara";
myCounter = 0;
estimateScreen = 1;
}
myCounter = myCounter+1;
RESULT = print;'

Response:

{"ruleId":11000001,"name":"Ambit App","categoryId":0,"activityId":1,"userCount":1,"binary":[73,65,77,82,85,76,69,0,8,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,144,0,0,0,44,0,52,0,62,0,72,0,82,0,90,0,108,0,126,0,0,0,114,117,108,101,48,0,255,191,82,69,83,85,76,84,0,0,255,63,112,114,101,102,105,120,0,0,255,63,112,111,115,116,102,105,120,0,255,63,116,105,116,108,101,0,10,0,83,85,85,78,84,79,95,68,73,83,84,65,78,67,69,0,18,0,83,85,85,78,84,79,95,65,86,71,95,83,80,68,0,0,11,0,83,85,85,78,84,79,95,68,85,82,65,84,73,79,78,0,4,0,3,0,19,0,0,0,0,0,0,0,0,0,0,0,0,0,4,0,1,0,0,0,0,0,2,0,0,0,32,0,6,0,0,0,0,0,6,0,0,0,32,0,2,0,0,0,0,0,12,0,0,0,32,0,1,0,0,0,0,0,14,0,0,0,4,0,1,0,0,0,0,0,16,0,0,0,4,0,1,0,0,0,0,0,20,0,0,0,4,0,1,0,0,0,0,0,24,0,0,0,4,0,0,0,0,0,0,0,28,0,0,0,160,0,1,0,0,0,0,0,0,0,0,0,4,0,0,0,0,0,0,0,32,0,0,0,4,0,0,0,0,0,0,0,36,0,0,0,4,0,0,0,0,0,0,0,40,0,0,0,160,0,4,0,0,0,0,0,2,0,0,0,160,0,2,0,0,0,0,0,6,0,0,0,160,0,3,0,0,0,0,0,8,0,0,0,160,0,4,0,0,0,0,0,12,0,0,0,160,0,6,0,0,0,0,0,16,0,0,0,160,0,5,0,0,0,0,0,22,0,0,0,44,0,28,0,0,0,82,117,110,0,104,0,53,75,0,0,49,48,75,0,49,47,50,32,77,0,77,97,114,97,0,0,54,2,28,8,0,22,48,0,25,16,9,24,89,2,0,25,16,9,24,89,3,0,25,16,9,24,89,4,0,144,0,0,0,0,21,10,0,144,0,0,0,0,21,11,0,144,0,0,0,0,21,12,0,16,1,21,8,0,28,5,0,28,6,0,12,28,7,0,12,22,6,0,13,238,1,18,234,1,20,5,0,144,111,18,131,58,3,144,0,0,128,63,5,20,12,0,144,0,0,0,0,9,11,22,57,0,144,0,0,128,63,20,5,0,144,111,18,131,58,3,2,144,0,0,122,68,3,20,6,0,144,102,102,102,64,3,144,228,56,142,62,3,4,21,10,0,25,16,13,24,89,2,0,25,16,14,24,89,3,0,20,5,0,144,111,18,131,58,3,144,0,0,128,63,8,20,12,0,144,0,0,0,0,9,11,22,19,0,144,0,0,128,63,21,12,0,144,0,0,0,0,21,11,0,20,12,0,144,0,0,128,63,9,20,11,0,144,0,0,0,64,8,11,22,66,0,20,7,0,144,0,64,156,69,20,5,0,144,111,18,131,58,3,144,0,0,122,68,3,4,144,20,174,135,63,33,12,0,1,0,2,0,3,21,10,0,25,16,15,24,89,2,0,144,0,0,0,0,21,11,0,144,0,0,0,64,21,12,0,20,12,0,144,0,0,0,64,9,20,11,0,144,0,0,0,64,8,11,22,66,0,20,7,0,144,0,64,28,70,20,5,0,144,111,18,131,58,3,144,0,0,122,68,3,4,144,20,174,135,63,33,12,0,1,0,2,0,3,21,10,0,25,16,16,24,89,2,0,144,0,0,0,0,21,11,0,144,0,0,64,64,21,12,0,20,12,0,144,0,0,64,64,9,20,11,0,144,0,0,0,64,8,11,22,66,0,20,7,0,144,0,210,164,70,20,5,0,144,111,18,131,58,3,144,0,0,122,68,3,4,144,20,174,135,63,33,12,0,1,0,2,0,3,21,10,0,25,16,17,24,89,2,0,144,0,0,0,0,21,11,0,144,0,0,128,64,21,12,0,20,12,0,144,0,0,128,64,9,20,11,0,144,0,0,0,64,8,11,22,66,0,20,7,0,144,0,211,36,71,20,5,0,144,111,18,131,58,3,144,0,0,122,68,3,4,144,20,174,135,63,33,12,0,1,0,2,0,3,21,10,0,25,16,18,24,89,2,0,144,0,0,0,0,21,11,0,144,0,0,128,63,21,12,0,20,11,0,144,0,0,128,63,1,21,11,0,20,10,0,21,1,0,13,4,0,19,31,0],"compatibleVariants":["Colibri","Duck","Emu","Finch","Greentit","Ibisbill","Jabiru","Kaka","Loon"]}

Known issues

• Not properly tested
• Lacks proper error handling
• No way to pass app name/title, category/activity as params n etc.

Thanks @margusl for feedback

[isazi]

[A Former User]

@pavel-samokha said in Ambit Apps Compilation:

Service to compile Ambit Apps into binaries ready for uploading to the watch after Movescount no longer availa

I’m head over heels in love with this.
kudos to Suunto!

[Stas Varazhbit]

I don’t understand a damn thing about it .But it’s cool to be able to do structured training for A3P again. And I’m very happy for those who understand how to do it.

[sebchastang]

@pavel-samokha @margusl One of the best posts of the year

Thanks for this

[sebchastang]

Is it possible to create new apps with this method?
How can we set the output format (0 decimal, 1 decimal, time, …)?
How to declare new variables?
Do we set prefix and postfix values just like other variables?

Thanks a lot for help.

It is definitely a great step forward to be able to edit Suunto Apps using a command line but it would be much more easy in a graphical way. Any plan for such a user interface?

[zt_zzzzz]

@pavel-samokha
Excellent

[zt_zzzzz]

ask for advice，how to use it?

[Aleksander H]

We’ll, this is just plain wonderfull!

[pavel.samokha]

@sebchastang said in Ambit Apps Compilation:

Is it possible to create new apps with this method?

I assume so, though as it lacks proper error handling n etc I’d rather see it as a tool for existing apps users to adjust existing app settings than developing app from scratch.

How to declare new variables?

See “detailed instructions” section on user variables and sample request. Is that what you are asking for or something else?

How can we set the output format (0 decimal, 1 decimal, time, …)?
Do we set prefix and postfix values just like other variables?

I just added info about that int “detailed instructions” section

It is definitely a great step forward to be able to edit Suunto Apps using a command line but it would be much more easy in a graphical way. Any plan for such a user interface?

Well, it’s not difficult to create simple UI for that (like editor form & compilation output, not trying to copy Movescount UI) but not sure if I have time to do that and when. Also may be even better to integrate such UI into SL, but we’re unlikely have resources to do that soon.

[sebchastang]

@pavel-samokha Thanks for the clarification and answers.

I also think it is more a way to modify an existing app than creating a new ones.

I asked for new variables because there was a specific section to declare them in movescount but I understand I have to declare and set variable values at the same time in the header section now.

[pavel.samokha]

Added Simple UI for Compiler

[Egika]

Now I have learned more old watches internal names

[sebchastang]

Hi,

I have compilation error when I set prefix and postfix values in the header section.
I have tried:
prefix = “xxx”
prefix = ‘xxx’
prefix = xxx

format is OK. Only prefix and postfix give errors.

Can anybody help me?
Thanks.

[A Former User]

@sebchastang did you put prefix/postfix in the header?
yes (sorry I’ve just relized you wrote that). I moved those in the code .

[pavel.samokha]

@sebchastang I’ll check on the weekend

[sebchastang]

@G-Q @pavel-samokha thanks for your answers.

[pavel.samokha]

@sebchastang prefix = xxx should work now

[sebchastang]

@pavel-samokha Thanks a lot!
It’s all good now

Do you think there is a possibility (in a near future) to give access to the app simulator we had in movescount to test the apps?

[pavel.samokha]

@sebchastang Unfortunately, I think it’s unlikely