Back to VSCP Modules

Current Harware Version: 0.0.5
Current Firmware version: 0.0.1

This is work in progress!!! Information here will change during development.

This projects inplements a node with 4 digital inputs, 7 digital outputs, 4 10-bit A/D inputs, 1 10-bit PWM output and a VSCP enabled serial interface. The SBC68EC module also have a VSCP enabled CAN interface.

The module will also at a later stage have the VSCP bootloader implemented but can also use the Modtronix bootloader in place if the hardware reversions of the board are higer then 1.0.

The reference design shows VSCP Level II communication. It shows

• how to discover a VSCP TCP server from a remote module.
• how to use a hard VSCP configured TCP server.
• VSCP UDP communication.

The reference design can be used on its own right as an automation tool but can easily be adopted to specific needs.

The module can communicate using TCP/IP to connect to a VSCP server using a static IP address. It can also use the High End Server discovery functionality of the protocol to find a server. In this case communication starts out using UDP communication and uses TCP communication when one or more servers are found. Also a UDP communication option is available.

Back to Nova Page

Two patches are needed on the Nova card as I missed to check two connections.

Here the groundplains need to be connected.

Even small chips need power…

Everything for the project can be downloaded at the following link
http://www.dosilos.se/download/hardware/nova

• Source: No release yet. See svn.
• Hex: No release yet. See svn.

• JPEG for schema: http://www.dosilos.se/download/hardware/nova/nova_sch002.jpg
• JPEG for Board: http://www.dosilos.se/download/hardware/nova/nova_brd002.jpg

• BMP for schema: http://www.dosilos.se/download/hardware/nova/nova_sch002.bmp
• BMP for Board: http://www.dosilos.se/download/hardware/nova/nova_brd002.bmp

• Modtronix site - http://www.modtronix.com
• 65EC page - http://www.modtronix.com/product_info.php?cPath=1_36&products_id=149
• Firmware page - http://www.modtronix.com/products/sbc65ec/firmware/

The module accept Level II read/write register events. The space is limited on the modules so a maximum of 24 registers can be read or written in one operation. All Level I CLASS1.PROTOCOL events are implemented, but only the read and write CLASS2.PROTOCOL events. Registers can therefore be read and written both with level I and Level II events.

Register 0(0x00) - Zone.
Register 1(0x01) - Subzone base for I/O. Lowest 5 bits should be zero (ignored) 
                   and are used for I/O pins 
                   and other zoned functionality as follows.
 
                   0 - General subzone for module.

                   1 - subzone for Input 0.
                   2 - subzone for Input 1.
                   3 - subzone for Input 2.
                   4 - subzone for Input 3.
                   5 - Reserved.
                   6 - Reserved.
                   7 - Reserved.
                   8 - Reserved.

                   9 - subzone for Output 0.
                   10 - subzone for Output 1.
                   11 - subzone for Output 2.
                   12 - subzone for Output 3.
                   13 - subzone for Output 4.
                   14 - subzone for Output 5.
                   15 - subzone for Output 6.
                   16 - Reserved.

                   17 - subzone for pin PWM Output.

                   18 - subzone for A/D 0.
                   19 - subzone for A/D 1.
                   20 - subzone for A/D 2.
                   21 - subzone for A/D 3.
                   22 - Reserved.
                   23 - Reserved.
                   24 - Reserved.
                   25 - Reserved.    

                   26 - Subzone for serial channel.
     
                   27 - Subzone for CAN channel.
                   
                   28 - Reserved. 
                   29 - Reserved. 
                   30 - Reserved. 
                   31 - Reserved.         

Register 2(0x02) - Reserved

Register 3(0x03) - Module Control Register.

• Bit 0 - Enable external Vref- on RA2.
• Bit 1 - Enable external Vref+ on RA3.
• Bit 2 - Reserved.
• Bit 3 - Reserved.
• Bit 4 - Make PWM value persistent. PWM_PERSISTENT_BIT
• Bit 5 - Reserved.
• Bit 6 - Enable Output periodic events. ENABLE_PERIODIC_OUTPUT_EVENTS
• Bit 7 - Enable Input periodic events. ENABLE_PERIODIC_INPUT_EVENTS

Note on PWM_PERSISTENT_BIT
If you want to write just a persitent value for the PWM and after that current PWM values that should not be persistent. Enable this bit, write a value and the reset the bit again. This will load the PWM with the value written when the bit was set on the next startup.

For Output/Input events CLASS1.DATA TYPE=1 (I/O) is sent with data coding set to 0x20 (vscp_specification_data_coding). This means the frame get the following content

Register 4(0x04) - Auto event interval in seconds. 0 is disabled. Read/write.

Set the interval in seconds between inteval events.

Register 5(0x05) - Input status, bit 0-7.

Read the input state for one of the buffered input bits.

Register 6(0x06) - Output status, bit 0-7.

Register 7(0x07) - A/D Control Register periodic events.

Set corresponding bit in this register to enable periodic events.

Register 8(0x08) - A/D Control Register Alarm low.

Set corresponding bit in this register to enable low alarm.

Register 9(0x09) - A/D Control Register Alarm high.

Set corresponding bit in this register to enable low alarm.

Register 10(0x0A) - Output 0 Control Register.  Read/Write
Register 11(0x0B) - Output 1 Control Register.  Read/Write
Register 12(0x0C) - Output 2 Control Register.  Read/Write
Register 13(0x0D) - Output 3 Control Register.  Read/Write
Register 14(0x0E) - Output 4 Control Register.  Read/Write
Register 15(0x0F) - Output 5 Control Register.  Read/Write
Register 16(0x10) - Output 6 Control Register.  Read/Write
Register 17(0x11) - Output 7 Control Register.  Read/Write

The output control bits enable disable intelligent output functionality

• Bit 0 - Initial startup output state. 1 = high, 0=low.
• Bit 1 - Reserved.
• Bit 2 - Protection timer enable.
• Bit 3 - Reserved.
• Bit 4 - Reserved.
• Bit 5 - Reserved.
• Bit 6 - Reserved.
• Bit 7 - If set to one the output is enabled. Disabled output stays at initial state.

Register 18(0x12) - Input 0 Control Register.  Read/Write
Register 19(0x13) - Input 1 Control Register.  Read/Write
Register 20(0x14) - Input 2 Control Register.  Read/Write
Register 21(0x15) - Input 3 Control Register.  Read/Write
Register 22(0x16) - Input 4 Control Register.  Read/Write
Register 23(0x17) - Input 5 Control Register.  Read/Write
Register 24(0x18) - Input 6 Control Register.  Read/Write
Register 25(0x19) - Input 7 Control Register.  Read/Write

The input control bits enable disable intelligent input functionality

• Bit 0 - Reserved.
• Bit 1 - Send Alarm event when input goes to high state.
• Bit 2 - Send Off event when input goes to low state.
• Bit 3 - Send On event when input goes to high state.
• Bit 4 - Reserved.
• Bit 5 - Reserved.
• Bit 6 - Reserved.
• Bit 7 - If set to one the input is enabled.

Register 26(0x1A) - Protection time output 0 (seconds) MSB. Read/Write
Register 27(0x1B) - Protection time output 0 (seconds) LSB. Read/Write
Register 28(0x1C) - Protection time output 1 (seconds) MSB. Read/Write
Register 29(0x1D) - Protection time output 1 (seconds) LSB. Read/Write
Register 30(0x1E) - Protection time output 2 (seconds) MSB. Read/Write
Register 31(0x1F) - Protection time output 2 (seconds) LSB. Read/Write
Register 32(0x20) - Protection time output 3 (seconds) MSB. Read/Write
Register 33(0x21) - Protection time output 3 (seconds) LSB. Read/Write
Register 34(0x22) - Protection time output 4 (seconds) MSB. Read/Write
Register 35(0x23) - Protection time output 4 (seconds) LSB. Read/Write
Register 36(0x24) - Protection time output 5 (seconds) MSB. Read/Write
Register 37(0x25) - Protection time output 5 (seconds) LSB. Read/Write
Register 38(0x26) - Protection time output 6 (seconds) MSB. Read/Write
Register 39(0x27) - Protection time output 6 (seconds) LSB. Read/Write
Register 40(x028) - Protection time output 7 (seconds) MSB. Read/Write  
Register 41(0x29) - Protection time output 7 (seconds) LSB. Read/Write

This is the output protection time. A output will be inactivated if not written to before this time has elapsed.
Set to zero to disable (default). The max time is 65535 seconds which is about 18 hours.

The registers can be as an example be used as a security feature to ensure that an output is deactivated after a preset time even if the controlling device failed to deactivate the relay.

Register 42(0x2A) - A/D value 0 MSB. Read Only.
Register 43(0x2B) - A/D value 0 LSB. Read Only.
Register 44(0x2C) - A/D value 1 MSB. Read Only.
Register 45(0x2D) - A/D value 1 LSB. Read Only.
Register 46(0x2E) - A/D value 2 MSB. Read Only.
Register 47(0x2F) - A/D value 2 LSB. Read Only.
Register 48(0x30) - A/D value 3 MSB. Read Only.
Register 49(0x31) - A/D value 3 LSB. Read Only.
Register 50(0x32) - Reserved.
Register 51(0x33) - Reserved.
Register 52(0x34) - Reserved.
Register 53(0x35) - Reserved.
Register 54(0x36) - Reserved.
Register 55(0x37) - Reserved.
Register 56(0x38) - Reserved.
Register 57(0x39) - Reserved.

The read value is in the range 0-1023.

Register 58(0x3A) - Reserved.
Register 59(0x3B) - Reserved.
Register 60(0x3C) - Reserved.
Register 61(0x3D) - Reserved.
Register 62(0x3E) - Reserved.
Register 63(0x3F) - Reserved.
Register 64(0x40) - Reserved.
Register 65(0x41) - Reserved.

Register 66(0x42) - PWM value MSB. Read/Write.
Register 67(0x43) - PWM value LSB. Read/Write.

The read/written value is in the range 0-1023. Both values has to be written to actually set the PWM. The data is transfered to the PWM register when the LSB byte is written.

The value here is normally not persistent so a reset will write zero. However it is possible to make it persistent by enabling the PWM_PERSISTENT_BIT in the module control register.

Values greater the 0x3ff written to the PWMregisters will be masked to appropriate value.

Register 68(0x44) - Serial baudrate + control bits.

• Bits 0-3

• bits 4-7 reserved

Register 69(0x45) - Reserved. 

Register 70(0x46) - Serial channel control register.

• Bit 0 - Enable confirm events.
• Bit 1 - Reserved.
• Bit 2 - Reserved.
• Bit 3 - Reserved.
• Bit 4 - Enable serial stream events output to serial channel.
• Bit 5 - Enable serial stream events on input from serial channel.
• Bit 6 - Port open status. Set to one to open zero to close port. Read to see if open/closed.
• Bit 7 - Persistent open/close. Set state for port when board is started.

Register 71(0x47) - A/D min value 0 MSB. Read/Write.
Register 72(0x48) - A/D min value 0 LSB. Read/Write.
Register 73(0x49) - A/D min value 1 MSB. Read/Write.
Register 74(0x4A) - A/D min value 1 LSB. Read/Write.
Register 75(0x4B) - A/D min value 2 MSB. Read/Write.
Register 76(0x4C) - A/D min value 2 LSB. Read/Write.
Register 77(0x4D) - A/D min value 3 MSB. Read/Write.
Register 78(0x4E) - A/D min value 3 LSB. Read/Write.
Register 79(0x4F) - A/D min value 4 MSB. Read/Write.
Register 80(0x50) - A/D min value 4 LSB. Read/Write.
Register 81(0x51) - A/D min value 5 MSB. Read/Write.
Register 82(0x52) - A/D min value 5 LSB. Read/Write.
Register 83(0x53) - A/D min value 6 MSB. Read/Write.
Register 84(0x54) - A/D min value 6 LSB. Read/Write.
Register 85(0x55) - A/D min value 7 MSB. Read/Write.
Register 86(0x56) - A/D min value 7 LSB. Read/Write.

Register 87(0x57) - A/D min value 0 MSB. Read/Write.
Register 88(0x58) - A/D min value 0 LSB. Read/Write.
Register 89(0x59) - A/D min value 1 MSB. Read/Write.
Register 90(0x5A) - A/D min value 1 LSB. Read/Write.
Register 91(0x5B) - A/D min value 2 MSB. Read/Write.
Register 92(0x5C) - A/D min value 2 LSB. Read/Write.
Register 93(0x5D) - A/D min value 3 MSB. Read/Write.
Register 94(0x5E) - A/D min value 3 LSB. Read/Write.
Register 95(0x5F) - A/D min value 4 MSB. Read/Write.
Register 96(0x60) - A/D min value 4 LSB. Read/Write.
Register 97(0x61) - A/D min value 5 MSB. Read/Write.
Register 98(0x62) - A/D min value 5 LSB. Read/Write.
Register 99(0x63) - A/D min value 6 MSB. Read/Write.
Register 100(0x64) - A/D min value 6 LSB. Read/Write.
Register 101(0x65) - A/D min value 7 MSB. Read/Write.
Register 102(0x66) - A/D min value 7 LSB. Read/Write.

Register 103(0x67) - A/D alarm hysteresis. Read/Write.

There must be a difference with this amount from the A/D alarm value for an alarm state to be reseted.

Register 104(0x68) - CAN control 

• Bit 0-3 - CAN bitrate.
  • 0 - 10 kbps
  • 1 - 20 kbps
  • 2 - 50 kbps
  • 3 - 100 kbps
  • 4 - 125 kbps (default)
  • 5 - 250 kbps
  • 6 - 500 kbps
  • 7 - 800 kbps
  • 8 - 1000 kbps
• Bit 4 - Reserved.
• Bit 5 - Reserved.
• Bit 6 - CAN channel open status. Set to one to open zero to close channel. Read to see if open/closed.
• Bit 7 - Persistent open/close. Set state for channel when board is started.

Register 105(0x69) - CAN mask for type MSB
Register 106(0x6A) - CAN mask for type 
Register 107(0x6B) - CAN mask for type 
Register 108(0x6C) - CAN mask for type LSB

mask for VSCP CAN traffic

Register 109(0x6D) - CAN filter for class MSB
Register 110(0x6E) - CAN filter for class 
Register 111(0x6F) - CAN filter for type 
Register 112(0x70) - CAN filter for type LSB

filter for VSCP CAN traffic

GUID for CAN channel. This is a full GUID without the least significant byte which is used as a nickname id for units on the CAN bus. Events sent from the CAN bus is translated using the nickname and this GUID. Events sent to this GUID is is sent out on the CAN bus usning the least significant byte as the nickname.

Register 113(0x71) - CAN Channel GUID MSB
Register 114(0x72) - CAN Channel GUID
Register 115(0x73) - CAN Channel GUID
Register 116(0x74) - CAN Channel GUID
Register 117(0x75) - CAN Channel GUID
Register 118(0x76) - CAN Channel GUID
Register 119(0x77) - CAN Channel GUID
Register 120(0x78) - CAN Channel GUID
Register 121(0x79) - CAN Channel GUID
Register 122(0x7A) - CAN Channel GUID
Register 123(0x7B) - CAN Channel GUID
Register 124(0x7C) - CAN Channel GUID
Register 125(0x7D) - CAN Channel GUID
Register 126(0x7E) - CAN Channel GUID
Register 127(0x7F) - CAN Channel GUID LSB-1

Page 1,2,3,4 holds four each of the decision Matrix rows.

Register space above 0xff is available for level II. Space between 0x100 and 0x2ff is recserved for the sixteen decision matrix rows. Space between 0x10000 and 0x1ffff is the raw content of the external EEPROM. Space above 0x8000 is used for web pages so if the web server is used this space should not be used. Space between 0x2000 - 0x7ffff is not used by the module at the moment and can be used freely by the user.

The decison Matrix for the Nova module is of Level II type
¹⁾
and there can be a maximum of 16 rows with an max argument count of max 18 bytes making each DM entry a total of 14 + 18 = 32 bytes. The page feature of the register space is useed to address thees registers using CLASS1.PROTOCOL events and in register space 256 and upwards for CLASS2.PROTOCOL events.

For CLASS1.PROTOCOL the MSB byte of the address below is the LSB of the page select (MSB is always 0x00).

• 0x0100 - DM row 0
• 0x0120 - DM row 1
• 0x0140 - DM row 2
• 0x0160 - DM row 3
• 0x0180 - DM row 4
• 0x01A0 - DM row 5
• 0x01C0 - DM row 6
• 0x01E0 - DM row 7

• 0x0200 - DM row 8
• 0x0220 - DM row 9
• 0x0240 - DM row 10
• 0x0260 - DM row 11
• 0x0280 - DM row 12
• 0x02A0 - DM row 13
• 0x02C0 - DM row 14
• 0x02E0 - DM row 15

The matrix can also be reached in Level I register space on page 1,2,3,4 each with four rows.

Format of DM

The module have a decision matrix with 16 entries.

DM enteries are handled in order and if more then one row match the corresponding action will be carried out wiyj the firts entry found followed by higer numbers. This means sending aserial string can consist of many rows that each will send out there content.

0(0x00) - NOOP, No action.

1(0x01) - Activate output(s) given by argument. The argument is a bit array where bit 0 is 
          relay 1 and so on. 
          Byte 1 is Zone and byte 2 is zone page and must be equal to register content to 
          trigger action.

2(0x02) - Deactivate output(s) given by argument. The argument is a bit array where bit 0 is 
          relay 1 and so on.  
          Byte 1 is Zone and byte 2 is zone page and must be equal to register content to 
          trigger action.

3(0x03) - Send data in argument on serial port. Data should be NULL terminated.

4(0x04) - Send predefined data on serial port from file as of argument. The file should be 
          compiled in as on of the files that buld up the web pages.

5(0x05) - Open serial port.

6(0x06) - Close Serial port.

7(0x07) - Open CAN port.

8(0x08) - Close CAN port.

9(0x09) - Send data in argument on CAN port.
               Argument Byte 0 - MSB of CLASS  ( Level I class can be max 511 )
               Argument Byte 1 - LSB of CLASS 
               Argument Byte 2 - MSB of TYPE 
               Argument Byte 3 - LSB of TYPE       
               Argument Byte 4 - LSB of TYPE
               Argument Byte 5 - Datacount (0-8)
               Argument Byte 6-13 - data

10(0x0a) - Send Output status. The argument is a bit array where bit 0 is output 0 and so on. 
           ON/OFF events are sent.

11(0x0b) - Send Input status. The argument is a bit array where bit 0 is input 0 and so on. 
           ON/OFF events are sent.

12(0x0c) - Send A/D value(s). The argument is a bit array where bit 0 is A/D 0 and so on. 
           A/D event is sent.

13(0x0d) - Send Output status. I/O event is sent instead of ON/OFF events as of above.

14(0x0e) - Send Input status. I/O event is sent instead of ON/OFF events as of above.

15(0x0f) - Set PWM as of argument. Byte 0 is MSB, Byte 1 is LSB.

16(0x10) - Reserved. 

• Bit 0 - A/D High/Low Alarm.
• Bit 7 - Alarm condition.

If enabled the event is sent when a input/outputgoes to its active state.

Class: 0x014 
Type: 0x03

Package:

Byte 0: Index.
Byte 1: Zone
Byte 2: Subzone

Index is always 0.

If enabled the event is sent when a input/outputgoes to its inactive state.

Class: 0x014 
Type: 0x04

Package:

Byte 0: index.
Byte 1: Zone
Byte 2: Subzone

Index is always 0.

If enabled the event is sent when a input/outputgoes to its inactive state.

Class: 0x014 
Type: 0x18

Package:

Byte 0: index.
Byte 1: Zone
Byte 2: Subzone

Index is always 0.

If enabled the event is sent when a input/output goes to its active state.

Class: 0x014 
Type: 0x19

Package:

Byte 0: index.
Byte 1: Zone
Byte 2: Subzone

Index is always 0.

If enabled the event is sent when a output goes to its low state after a protection timer have timed out or when an input goes to a triggered state.

Class: 0x001 
Type: 0x02

Package:

Byte 0: index.
Byte 1: Zone
Byte 2: Subzone

Index is always 0.

I/O measurements are sent with this event.

Class: 0x00f
Type: 0x01

Package:

Byte 0: Datacoding.
Byte 1: I/O value

The datacoding is set to integer and is 0b01100xxx where xxx = 0 for inputs and xxx = 1 for outputs.

A/D measurements are sent with this event.

Class: 0x00f 
Type: 0x02

Package:

Byte 0: Datacoding.
Byte 1: MSB of A/D reading.
Byte 2: LSB of A/D reading.

The datacoding is set to integer and is 0b01100xxx where xxx is index for A/D converter.

Node heartbeat send out.

Class: 0x014 
Type: 0x02

Package:

Byte 0: 0.
Byte 1: Zone.
Byte 2: 0 (subzone for module).

A heartbeat is sent once every minute.

Node heartbeat send out.

Class: 0x014 
Type: 0x26

Package:

Byte 0: Zone.
Byte 1: SubZone.
Byte 2: Sequence number.
Byte 3-7: Serial data

Use this event to send serial data to the serial channel of the module. Also this event is sent from the module when data is received on the serial channel. Confirm events are sent when stream data is received.

Nova connectors

Modtronix - Connector 1

Modtronix - Connector 2

Inputs

Outputs

Note: next rev change RB6 and RB7 position.

A/D Channels

Node heartbeat send out.

Class: 0x014 
Type: 0x27

Package:

Byte 0: Zone.
Byte 1: SubZone.
Byte 2: Sequence number.
Byte 3: Class MSB
Byte 4: Class LSB
Byte 5: Type MSB
Byte 6: Type LSB

1. 64k flash
2. 3840 RAM
3. RC2,4,5 I2C/SPI
4. Two UARTS, RC6-TX1, RC7-RX1, RG1-TX2, RG2-RX2

1. 64k flash
2. 3328 RAM
3. 1024 EEPROM
4. CAN enabled. RG0 - CANTX, RG2 - CANRX

There is no release of the VB code for Nova because I started to rewrite all UI components using wxWidgets and will use wxPython for RAD things in the future. Most of the stuff is there already so it may still be usble. The code is available in the VSCP project source repository. You can either use a subversion client like TortoiseSVN to get the source tree or download the dayly package. Instructions in our download page http://www.vscp.org/download The source for Nova including the VB app. is in the folder /firmware/pic/mx/nova_v304 of the source tree.

TestNova is a simpe Visual Basic test application that can be used to configure and/or test a Nova design. More information will be presented shortly about this software, but for now some pictures of its user interface. The code is available in the svn for those who can't wait to test it.

Two methods to talk to the TCP daemon is shown. One uses pure VB and the other uses the VSCP TCP ActiveX control.

The main screen let you set up the VSCP host you want to work through and the logon credentials. In the listbox found GUID's for nodes on the segment will be listed automatically. The GUID for node filed must be filled in with an available GUID before any other operations can be performed.

A menu give you access to a some functionality/control of the Nova node.

Standardregs are VSCP common registers. Some can be written and all can be read. Some test functionality is also present here for application developers. The read register function is done both the Level I way and the Level II way where several registers can be fetched in one operation. Someting that of course is much faster.

On the standard control form you can set the Xone and subzone base. Control the serial and the CAN channel and also some event enabling stuff.

The output tab show the output state and let you directly control it. You can also control how each output should behave and also set the protection time for each output.

The input tab show the state for the input channels. You can also control how each input should behave.

The A/D tab show the state for the A/D channels. You can also enable alrms and periodic events and set high/low alarmpoints.

The PWM tab let you control the PWM channel.

The sixteen Decision Matrix enteries can be controlled here

Show the content of the MDF file. Uses the Internet Explorer XML formating capabilities (not shown here of course… ;)).