Jennic Serial Port Tool

Use the Jennic Serial Port Tool to change properties of a wireless USB Jennic/Sedona adapter (coordinator), such as its Panid, channel, or debug level in the Workbench console. This view is also used in the “flasher” utility to serially download firmware from your Sedona Workbench PC to the SED-M0x module, via the DB-9 RS-232 port on the Sedona Dev Board.

NoteFor OEM provisioning details related to using the flasher utility, see App notes for Sedona Modules on target devices.

This view is divided into a top start banner and two halves below: Port table and Port details.

start banner

The start banner at the top of Jennic Serial Port Tool enables or disables all Jennic/Sedona related communications from Workbench to the configured serial ports.

Figure 25. Jennic Serial Port Tool “start banner” at top of view


Jennic Serial Port Tool “start banner” at top of view

  • When started , the other areas of the view (port table, port details) are active. A stop control is available to toggle the Jennic Serial Port Tool off.

  • When stopped , other view areas remain blank. A start control is available to toggle the tool on.

As shown, a checkbox “Auto-start Tool” is available.

NoteWhen using Sedona Workbench it is typically recommended you enable the “Auto start Tool” checkbox, so that the tool starts when Sedona Workbench starts.

Port table

The port table lists the Workbench PC’s COM ports, by COMn assignment (Figure 26).

Figure 26. Example Port table in Jennic Serial Port Tool


Example Port table in Jennic Serial Port Tool

Each port specifies the “type” of Jennic/Sedona configuration for that port, which is either:

  • unknown — (default) no usage by Jennic/Sedona

  • adapter — the wireless Jennic USB adapter with Sedona firmware

  • flasher — an available PC COM port to use in a “flasher” serial firmware download routine to a serially cabled Sedona device (e.g., the Sedona Dev Board).

    NoteIf a port is already set to “adapter”, the “flasher” option is not available in the Type drop-down menu. Instead, a “Flash” button is provided among the Buttons in the lower pane.

Initially all ports will be “unknown”, but after you run the New Jennic Wireless Adapter wizard, one port remains as an adapter. See Start Sedona Workbench and configure the adapter.

Port details

Below the Port table are details for any selected port row, if type “adapter” or “flasher”.

Figure 27. Example port details (adapter) in Jennic Serial Port Tool


Example port details (adapter) in Jennic Serial Port Tool

As shown in Figure 27, properties for an “adapter” include:

  • Panid — the Jennic PAN ID (Personal Area Network identifier), in hexadecimal, range 0x0000 to 0xFFFE for the network. The wireless USB adapter acts as the coordinator for this network.

  • Channel — the RF 2.4GHz channel number to use, from 11 to 26.

  • Diag Level — level of Jennic/Sedona-related debug messaging to include in the Workbench console window, where value of 0 provides the smallest level. See Sedona Workbench console.

NoteChanging the value of an adapter’s Panid or Channel, after a save, causes a restart of that adapter.

When looking at an adapter’s details, note the view includes a row of Buttons at the bottom.

Details for a port set to “flasher” change the view significantly, as shown in Figure 28.

Figure 28. Flasher details in Jennic Serial Port Tool


Flasher details in Jennic Serial Port Tool

Flasher utility items include:

  • Firmware Archive — Workbench file path (ord) to the appropriate firmware archive file to download serially to the Sedona SED-M0x module in this utility. An open folder icon produces the standard Workbench File Chooser dialog, so you can browse to the needed location of this file.

  • Flash button, to initiate the download (only after connecting the DB-9M to DB-9F serial cable between the Workbench PC and the Sedona Dev Board, and setting the board in “program mode” via pushbutton switched SW7 and SW5).

When in this flasher utility mode, no other buttons are available in the Jennic Serial Port Tool.

Buttons

Buttons at the bottom of the Jennic Serial Port Tool are available only when a COM port of type “adapter” is selected.

Figure 29. Buttons at bottom of Jennic Serial Port Tool (when adapter port selected)


Buttons at bottom of Jennic Serial Port Tool (when adapter port selected)

These buttons are described as follows:

  • Refresh

    Refreshes values in this view; this button is always available.

  • Save

    Becomes enabled if a change is made in any of an adapter’s three properties. Note that any saved change to Panid or Channel also causes a restart of the wireless USB adapter.

  • Disconnect

    To disconnect and restart adapter with new Panid and/or Channel settings. As shown in Figure 30, the details change to show current settings as well as entry fields for new settings.

    Figure 30. Disconnect shows current settings (right) and entry fields for new (left)


    Disconnect shows current settings (right) and entry fields for new (left)

    Click the Connect button to restart the adapter with the new settings, resuming the normal view.

  • Restart

    To restart the wireless USB adapter, with a popup dialog that displays progress during this period.

  • Refresh PAN

    To silently refresh the network tables maintained in the wireless USB adapter.

  • Flash

    To load a firware update in the wireless USB adapter. A file chooser dialog results—you typically navigate to the !sedona/jennic/firmware folder for a sedonaDist-ZR154*.zip file.