Quick Start Best Practices - Commonly Referenced Links to Review and Bookmark

[espruino-discuss2]

Posted at 2021-08-28 by Robin

Sat 2021.08.28

After countless forum responses kept bringing me back to the same content time and time again, I realized a quick launch page similar to the FAQ's and Tips and Tricks pages is needed. Modified from an on-going list previously maintained in 'Writing an effective forum post'

English not your native language? Make use of these online translation tools:

https://translate.google.com/
https://www.deepl.com/translator

Flash firmware

From the WebIDE :: Settings >> Flasher

https://www.espruino.com/Download#flashi­ng
https://github.com/espruino/Espruino/blob/master/README_BuildProcess.md

Current Espruino versions and release dates

https://github.com/espruino/Espruino/rel­eases
https://www.espruino.com/ChangeLog
http://www.espruino.com/binaries/travis/­master/

Three WebIDE variants

Chrome Web Store IDE should 'just work'
Installing native app
Easiest but it needs an up to date version of Chrome
Version 85.0.4183.102 (Official Build) (64-bit) some recent older versions do work also (2020.09.22)
Version 92.0.4515.131 (Official Build) (64-bit) (current 2021.08.28)

Common 'Gotchas'

Issues on start up after save()

Quick Start Best Practices - Proper way to call init()

ES5 vs ES6

http://www.espruino.com/Features

Which Javascript Standards Version and Javascript Language Reference should be used?

Frequently referenced pages:

http://www.espruino.com/Tips+and+Tricks

http://www.espruino.com/Troubleshooting

http://www.espruino.com/Tutorials

http://www.espruino.com/Saving

http://www.espruino.com/Reference#software

http://www.espruino.com/Debugger

http://www.espruino.com/Quick+Start

https://www.espruino.com/Quick+Start+BLE

http://www.espruino.com/Features

http://www.espruino.com/Fonts

https://www.espruino.com/Internals

https://www.espruino.com/Performance

http://www.espruino.com/FAQ

Steps to locate Espruino source code *(in this case the embedded WiFi module source)*

http://www.espruino.com/Reference#Wifi
selected connect() function
http://www.espruino.com/Reference#t_l_Wifi_connect

Locate and click the Right Facing arrow adjacent to the heading, which takes one to:

https://github.com/espruino/Espruino/blob/master/libs/network/jswrap_wifi.c#L207

Back up the tree in order to locate source code for other functions

Steps to locate Fonts source code *(in this case the Font7x11Numeric7Seg font)*

Typing 'Fonts' into the Search field at the upper right of most Espruino pages.

http://www.espruino.com/Fonts

Noting that right clicking on almost every listed font takes one to:

http://www.espruino.com/modules/

Searching that list finds the desired Font7x11Numeric7Seg font.

http://www.espruino.com/modules/Font7x11­Numeric7Seg.js
http://www.espruino.com/Bangle.js+Clock+Font

Bangle specific

https://banglejs.com/reference
https://banglejs.com/apps/
https://github.com/espruino/EspruinoDocs/blob/master/info/Troubleshooting%20Bangle.js.md

Emulator

https://www.espruino.com/ide/?emulator
http://forum.espruino.com/conversations/341313/

Which Bangle hardware version do I have?

https://www.espruino.com/Bangle.js
https://www.espruino.com/Bangle.js2

Bangle.js 2 only has a single button, while the original standard Bangle has 3 buttons

Steps to locate Bangle app source code: *(in this case the touch event within 'Touch Launcher' app source)* > https://banglejs.com/apps/

Find the 'GitHub' icon to the left below app title 'Touch Launcher' and R-Click open which will take you to: [Line 230]

https://github.com/espruino/BangleApps/b­lob/master/apps/toucher/app.js#L230

Web page control of Bangle: See heading below: *Puck bi-directional Try It examples here*

Bluetooth BLE

BLE 16-bit UUID Numbers Document

https://www.bluetooth.com/specifications/assigned-numbers/
https://btprodspecificationrefs.blob.core.windows.net/assigned-values/16-bit%20UUID%20Numbers%20Document.pdf

https://create.arduino.cc/projecthub/dho­rton668/bluetooth-weather-station-40d1e4­

Puck bi-directional Try It examples here:

https://www.espruino.com/Web%20Bluetooth
https://www.puck-js.com/go

Javascript Language Reference

The Mozilla Developer Network 'MDN' reference along with w3c.org standards are the places to go to understand the language specifics, while W3Schools has a nice interactive try before coding editor-viewer.

https://www.w3schools.com/js/default.asp
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference
https://www.w3.org/TR/
https://tc39.es/ecma262/multipage/overview.html#sec-overview

@robin > End-user and five-year supporter of Original Espruino boards (circa January 2017)

P.S. Thank you for supporting the Espruino community with the purchase of an Authentic Espruino board

> Edits: > Sat 2021.08.28   Created > Sun 2021.010.03   Added Bangle web page BLE > Sat 2021.010.30   Added ECMA262 Specification
*Copyright 2021* ©