User Tools

Site Tools


arduino:wio-setup-en

French VersionDeutsche VersionEnglish Version

WIO - Setup

ContentArduino


Rocview → Menu → Programming → WIO


Remarks

  • No setup is possible if there are multiple devices with the same ID; Power on just one with that ID and change it.
  • This documentation is based on WIO 1.x firmware.


Query

Set

With the Set button the ID, name and Type can be changed.

Type Functions
Control Throttle using short IDs
LED 32 I2C I/O and FastLED
SERVO 32 I2C I/O and Servos
RFID 32 I2C I/O and RFID
DCC 32 I2C I/O and DCC CS or Booster
Mobile 32 I2C I/O and PWM to control a H-Bridge or RC ESC
CAM ESP32-CAM board support, no I/O possible.
CAN WiFi-TCP interface between 250kb CAN and Rocrail on port 5550

Reboot

Reboots the selected WIO module.

DeepSleep/Shutdown

Shutdown the selected WIO module.
All WIO modules will shutdown in case the All option is selected.

Report

wio-report.jpg A usage report is generated for all WIO modules in the query.
The default program wil be started to view the CSV file.

WEB Browser

This will open the default WEB Browser with the IP of the selected WIO to be able to maintain SPIFFS files.

CAM Stream

In case of type CAM the streaming link can be used:

http://<IP>:8081/stream

CAN

The extra service on port 5550 can be used to communicate with a CAN bus like MBUS.
A power off command is send to CAN if the WiFi or Rocrail connection is lost.


Setup

Pulse

Count of 100ms for setting the output pulse length.
Also used for dual coil switch motors.

Serial

The RX/TX pins on the ESP8266 are the same as used by the serial monitor.
The serial monitor will get read only, and swapped to another baudrate, when using the RX for other devices.

Monitor

Default serial Monitor at 57600bps.

RailCom

RailCom reader, GCA214, at 250.000bps.

RFID

RFID ID-12LA reader at 9600bps.

For RailCom and RFID: If the serial monitor is still needed for tracing, the baudrate must be adjusted in the Arduino IDE.

DCC

:!: In combination with a H-Bridge, WIO-Drive and WIO-Boost, the power monitor must be enabled to be able to power on. A WIO reboot is required!

Power monitor

Monitor the power consumption and shutoff at 1A. (Must be set for WIO-Drive and WIO-Boost.)

Max.3A

Shutoff at 3A instead of 1A. (Only in combination with the "Power monitor" option active.)

Booster

Use an external DCC 3V3 signal. (1.63+)
See the IBB connector on the WIO-Boost and WIO-Drive.
It will power off automatically in case no DCC signal is detected.

RailCom

Enable RailCom cutout in the preamble and idle packet.
Disable this option in case none RailCom decoders are used.

Fast PT

Only one packet stream instead of 4 x reset plus 6 x program are send to the PT.
Note: Not all decoders will accept this none NMRA conform sequence.

Mobile servo PWM

ESC PWM

In case of WIO Mobile, this option will set servo compatible PWM on the D5 pin, which can be used to connect a RC ESC. (Electronic Speed Control)


Display

Rotate 180°

Rotate the display content 180°.

Geometry

Select the connected displays geometry.


Control

Steps

Number of rotary ticks for 100% speed.

Deep sleep

Put WIO Control into deep sleep after a time out of x minutes.

Synchronize

Synchronize speed and function field events. Disable in case of a slow network to avoid slider jumping.
:!: This option will only work well in case the used Command Station reports speed changed at once. In all other cases the WIO-Control cannot set the loco speed.


Board

The board layout is automatically selected in case the selections does not fit to the architecture.
Only architecture ESP32 can be of different layouts.

ESP32 OLED

Development boards with embedded OLED display on I2C GPIO4 and GPIO5.

ESP32 CAM

Special ESP32-CAM with Servo support.


CAM

Select the desired camera stream framing size.
The WIO CAM must be rebooted to make this selection active.


Set

With the Set button the pulse length, options and the selected I2C field can be changed.


Maintenance

Setup the basic connections can be done on this tab:
ASCII���Screenshot

  1. Plug in the ESP cable into an USB port on the computer
  2. Query devices
  3. Select the ESP USB device from the list
  4. Connect
  5. Type in the connection parameters and push Set

The WIO is ready for use.

Note 1: Automatic Server needs an active R2RNet.
Note 2: The Identify Number must be set unique among all WIO's.

Query Devices

Query serial USB devices, and try to preselect one.

Connect

Try to make a 115200 baud connection with the selected serial device.

Disconnect

Disconnect from the serial device. This will be done automatically on closing the WIO Setup dialog.

WLAN

Name

SSID name to use for the WiFi connection.

Scan

Let the connected ESP search for available networks. This will fill up the Name combobox.

Password

The password for the selected SSID name. Activating the checkbox will makes the password readable.

Set

Sends the SSID name and password to the connected ESP.


Server

Name

The DNS name or IP address of the Rocrail server.

Automatic

Use UDP Multicast, R2RNet, to find a Rocrail server.

R2RNet

User besides TCP also UDP Multicast for RASCII communication. (WIP)

Set

Sends the server name to the connected ESP.


Identity & Type

Number

Unique node ID.

Name

Optional node name.

Type

WIO main function.

Set

Sends the ID and type to the connected ESP.


?

Refresh the terminal with the ?<enter> command.


I/O

Port usage.

Set

Sends the port usage to the connected ESP.


Debug/Info

Switch between Info and Debug trace level.


SoD

Sends a start of day command to the connected ESP.


Reset

Reset the part of the Flash memory on which the WIO configuration is located.


Update

WIO binaries for ESP8266 and ESP32 can be uploaded by OTA.
wiosetup-update-en.jpg

  1. Select the WIO on the Query tab.
  2. Goto the Update tab.
  3. Select the target binary; Can be downloaded here.
  4. Adjust the OTA password if needed. (Default is "12345678")
  5. Push the OTA button.

Start OTA

if the file name is left empty the selected WIO module will be set in OTA mode for updating the firmware over the air by other tools like the Arduino IDE.

OTA from Scratch

To avoid bothering with the needed libraries for the WIO Sketch this WPS-OTA-Sketch can be used for binary OTA:
( The Sketch can also be downloaded from https://gitlab.com/rocrail/wio/-/tree/master/RROTA )

  1. Install the Arduino IDE.
  2. Add the ESP boards: ESP Boards.
  3. Flash this Sketch on the target ESP.
  4. Open the Arduino serial monitor with 115200 baud.
  5. Put the WiFi router/repeater in WPS mode.
  6. Wait for the IP Address in the serial monitor.
  7. Select on the Update tab in the WIO Dialog the WIO binary.
  8. Set the IP address and port on the Update tab.
  9. Start OTA.
  10. Ready to setup the rest of the WIO on the Maintenance tab.

Alternatively a mDNS browser can be used for point 4 and 6.

mdns-browser-rrota.jpg ASCII���Screenshot
Discovery Arduino IDE → Tools → Ports → Network Ports
arduino/wio-setup-en.txt · Last modified: 2022/03/13 10:28 by rjversluis