You are here: OWFS 1-Wire File System » OWFS 1-Wire File System » Quickstart guide

Quickstart guide

  • This is a guide for starting on Ubuntu 12.04
  • Install the package
    • Open "Ubuntu Software Center" from the side bar.


      and select "Software Sources"
    • Then add to software sources

      Other software -> Canonical Partners
    • Finally select "owfs" packages
    • Installed components:
      • owfs (filesystem)
      • owftpd (ftp file server)
      • owhttpd (web server)
      • owserver (network protocol server)
    • Shell components can be install by searching for "ow-shell" (note the dash)
      • owdir
      • owread
      • owwrite
    • OPTIONAL: OWNet (lightweight language bindings) can be install by searching for "ownet"
      • only needed for program development
    • Default configuration file (/etc/owfs.conf)
      # Sample configuration file for the OWFS suite for Debian GNU/Linux.
      #
      #
      # This is the main OWFS configuration file. You should read the
      # owfs.conf(5) manual page in order to understand the options listed
      # here.

      ######################## SOURCES ########################
      #
      # With this setup, any client (but owserver) uses owserver on the
      # local machine...
      ! server: server = localhost:4304
      #
      # ...and owserver uses the real hardware, by default fake devices
      # This part must be changed on real installation
      server: FAKE = DS18S20,DS2405
      #
      # USB device: DS9490
      #server: usb = all
      #
      # Serial port: DS9097
      #server: device = /dev/ttyS1
      #
      # owserver tcp address
      #server: server = 192.168.10.1:3131
      #
      # random simulated device
      #server: FAKE = DS18S20,DS2405
      #
      ######################### OWFS ##########################
      #
      #mountpoint = /mnt/1wire
      #allow_other
      #
      ####################### OWHTTPD #########################

      http: port = 2121

      ####################### OWFTPD ##########################

      ftp: port = 2120

      ####################### OWSERVER ########################

      server: port = localhost:4304
      • The configuration file has to be specifically called on the command line.
      • The default configuration file creates "fake" devices
      • Uncomment lines (remove the "#") to use USB or serial bus masters
      • In the configuration file the ports used are:
        • owserver 4304 (the IANA assigned default)
        • owhttpd 2121
        • owftpd 2120
    • Default startup
      • These are the default processes started:

        959 ?        Ssl    0:00 /usr/bin/owftpd -c /etc/owfs.conf --pid-file /var/run/owfs/owftpd.pid
       1373 ?        Ss     0:00 /usr/bin/owhttpd -c /etc/owfs.conf --pid-file /var/run/owfs/owhttpd.pid
       1748 ?        Ss     0:00 /usr/bin/owserver -c /etc/owfs.conf --pid-file /var/run/owfs/owserver.pid

    • The startup files
      • owserver
        • network server
        • init file: /etc/init.d/owserver
        • Control
          sudo service owserver start
          sudo service owserver stop
          sudo service owserver restart
          sudo service owserver status
      • owhttpd
        • Web server
        • init file: /etc/init.d/owhttpd
        • Control
          sudo service owhttpd start
          sudo service owhttpd stop
          sudo service owhttpd restart
          sudo service owhttpd status
      • owftpd
        • FTP server
        • init file: /etc/init.d/owftpd
        • Control
          sudo service owftpd start
          sudo service owftpd stop
          sudo service owftpd restart
          sudo service owftpd status
  • First test -- fake devices
    • Use the web server
      Use the owhttpd already started in the init scripts (or start it up)
      sudo service owserver restart
      sudo service owhttpd restart
    • Start web browser at localhost:2121
    • The "fake" devices are circled.
  • Second test -- real devices:
    • USB (DS9490)
      • Edit the configuration file
        sudo gedit /etc/owfs.conf
        and change two lines
        server: FAKE = DS18S20,DS2405
        to
        #server: FAKE = DS18S20,DS2405
        and
        #server: usb = all
        to
        server: usb = all
        essentially masking fake devices and starting the USB bus
      • Restart owserver and owhttpd
        sudo service owserver restart
        sudo owserver owhttpd restart
      • Look at web browser to owhttpd address

        For a pretty full bus.
    • Serial bus master (DS9097U)
      • Edit the configuration file
        sudo gedit /etc/owfs.conf
        and remove the "Fake" entries 
        server: FAKE = DS18S20,DS2405
        to
        #server: FAKE = DS18S20,DS2405
      • Figure out the serial port name
        • Real serial ports: /dev/ttyS0 /dev/ttyS1, ...
        • USB to serial convertors: /dev/ttyUSB0, ...
      • Change the configuration file entry
        #server: device = /dev/ttyS1
        to
        server: device = /dev/ttyS1
      • Follow the same restart and test scheme as for the USB bus master above.

^ Top

Previous page: Test Survey
Next page: Vendors for 1-wire devices