See the preceding page for a much easier demonstration of real time updating of clients using Version 3.0 of Smart Mobile Studio. We retain this page (written in 2015) in case some of the code will be useful when using the unit SmartCL.Net.SocketIO.

For this demonstration of real-time updating we use the socket-io and node-static packages and recommend for the Raspberry Pi version 0.10.25 of Node.js (for which we provide annotated installation instructions). Our example is based on André Mussche's server-side Node.js tutorial that warrants a few additional notes in the next section. You will find any .pas units that are not provided with Smart Mobile Studio in the GitHub pages that André links to from his tutorial. Our client-server demo is intended to be run on a local network comprising PCs and/or Raspberry Pi computers rather than on Heroku.

Server-side Node.js by André Mussche

You can try a similar demo by pointing browsers at Be prepared for a short delay if the server has not been used recently.

In order to reproduce the demo, you should find the following points helpful.
  • When testing locally, port 80 may already be in use so try another such as 8079.
  • In order to use socketio.pas in the client, copy it to the project folder and add it to the project. (Right click on Unit1 in the Project manager, select menu item Add > Add External Source(s)..., select the file and click the Open button).
  • The code in is commented out. You can remove it from the uses clause in the file that is used by the server.
  • Since the tutorial was written, original versions of Node.js files have been superseded. We used this client version of Rename it to socketio, put it in the client project folder and it will be copied to the lib folder; socketioclient.pas includes the line {$R 'file:socketio.js'}. Remember to copy the lib folder if you copy the client HTML file to another location for download by the server.
  • The server will not display a message (other than 'Server running at ...') until a button in a client is clicked.
  • The initial message to the client upon connection is not handled by the client.
  • For those of you trying Heroku, see our notes on getting started. (This page is downloaded by our server on Heroku that we wrote in Smart Pascal with the help of André's tutorial).

Smart Pascal Code of Server

Replace the code of a new Node.js project named ButtonSizeServer with the following. (This is for a server stated to be running at the IP address but it will run at other addresses provided that Node.js is installed on the computer). You can compare this code with a JavaScript version.

unit Unit1;


  TServer = class
    ConnectionNum := 0;
    procedure Run;


  NodeJS.Core, NodeJS.http, Node_Static,;

procedure TServer.Run;
  var fileserver := TNodeStaticServer.Create('./public');
  //start http server
  var server: JServer := http.createServer(
    procedure(request: JServerRequest; response: JServerResponse)
      Console.log('http request: ' + request.url);
      if request.url = '/' then
        request.url := '/ButtonSizeClient.html';
      fileserver.serve(request, response);
  server.listen(8079, '');
  Console.log('Server running at');

  var value := 0;
  var io := socketio().listen(server);
  io.sockets.on('connection',    // waiting for connections
    procedure(socket: JSocketIO)
      ConnectionNum += 1;
      socket.emit('dataConnection', [ConnectionNum]);  // pushes connection number to client upon connection
      socket.on('requestFromClient',  // waiting for a special request from the client
        procedure(data: Variant; callback: JSocketIODataFunction)
          Console.log('Received from client: ' + data);
          value := data;
          if value > 500 then
            value := 80;
          io.sockets.emit('dataFromServer', [value]);  //send to all clients


Smart Pascal Code of Client Form

The form consists of only a label (elongated) in the top left corner and a button immediately under it. The OnClick event of the button is W3Button1Click.

unit Form1;


  SmartCL.System, SmartCL.Graphics, SmartCL.Components, SmartCL.Forms,
  SmartCL.Fonts, SmartCL.Borders, SmartCL.Application, SmartCL.Controls.Button,
  SmartCL.Controls.Label, socketioclient;

  TForm1 = class(TW3Form)
    procedure W3Button1Click(Sender: TObject);
    FSocket: JSocketIO;
    {$I 'Form1:intf'}
    procedure InitializeObject; override;


procedure TForm1.W3Button1Click(Sender: TObject);
  FSocket.emit('requestFromClient', [W3Button1.Width + 20],
               lambda end); // Concise code for empty callback

procedure TForm1.InitializeObject;
  {$I 'Form1:impl'}
  FSocket := socketio.connect('');
    procedure(aData: variant)
      W3Label1.Caption := 'Connection number: ' + aData;
    procedure(aData: variant)
      W3Button1.Width := aData;

  Forms.RegisterForm({$I %FILE%}, TForm1);

Set-up with the server on a PC

  1. Install a recent version of Node.js, change directory to that which will contain ButtonSizeServer.js, and install the required modules with npm install and npm install node-static.
  2. A folder named public on the server should be created in the output folder (or wherever you are going to put ButtonSizeServer.js.
  3. Copy ButtonSizeServer.js to where you will use it (if you are not running it from the output folder).
  4. Copy ButtonSizeClient.html and the lib folder to the public folder.
  5. Change directory in the Command Prompt to that containing ButtonSizeServer.js.
  6. Start the server with node ButtonSizeServer.
  7. Point browsers at and click the button in each.

Set-up with the server on a Raspberry Pi

  1. Install v0.10.25 of Node.js as detailed here.
  2. In the LXTerminal, change directory to where you will copy ButtonSizeServer.js. We show instructions for use of the /var/www folder on a Pi with IP address
  3. Type the command /opt/node/bin/npm install io-socket and wait for much logging of the installation.
  4. Type the command /opt/node/bin/npm install node-static (much quicker).
  5. Change the appropriate line in the server code to Console.log('Server running at'); and recompile.
  6. Copy ButtonSizeServer.js to the /var/www folder.
  7. Create a folder named public within the /var/www folder.
  8. Copy ButtonSizeClient.html and its lib folder to the public folder.
  9. Start the server with node ButtonSizeServer.
  10. Point browsers at and click the button in each.


Programming - a skill for life!

Using Node.js for a server that updates connected clients in real time